Registro de usuario

Crea una nueva cuenta de usuario en la plataforma Colurs (persona natural B2C o empresa B2B). Tras el registro, el sistema envía un correo de bienvenida y el usuario debe verificar su email y teléfono.

Este endpoint solo requiere API Key, no necesita autenticación previa.

Registro de Usuario

Autorización

Se requiere el header x-api-key para autorización.

Endpoint

POSThttps://dev.backend.colurs.co/user/

Headers Requeridos

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]

Request Body

Campo	Tipo	Requerido	Descripción
username	string	✓	Email válido para PANEL/API
email	string	✓	Correo electrónico
password	string	✓	Contraseña (max 100 chars)
phone	string	✓	Teléfono sin código país
country_code	string	✕	Código país (ej: 57)
first_name	string	✕	Nombre
last_name	string	✕	Apellido
document_type	string	✕	CC, CE, NIT, PASSPORT
document_number	string	✕	Número de documento
type_person	int	✓	1 = NATURAL, 2 = JURIDICAL
country_company_incorporation	string	⚠	Requerido si type_person=2
platform	string	✓	APP o PANEL
country	string	✓	Código país
referal_code	string	✕	Código de referido

request.json{
"username": "usuario@ejemplo.com",
"email": "usuario@ejemplo.com",
"password": "Password123!",
"first_name": "Juan",
"last_name": "Pérez",
"phone": "3001234567",
"country_code": "57",
"document_type": "CC",
"document_number": "1234567890",
"type_person": 1,
"platform": "API",
"country": "CO"
}

Ejemplo cURL

curl -X POST https://dev.backend.colurs.co/user/ \
-H "Content-Type: application/json" \
-H "x-api-key: [API_KEY]" \
-d '{
  "username": "usuario@ejemplo.com",
  "email": "usuario@ejemplo.com",
  "password": "Password123!",
  "first_name": "Juan",
  "last_name": "Pérez",
  "phone": "3001234567",
  "country_code": "57",
  "document_type": "CC",
  "document_number": "1234567890",
  "type_person": 1,
  "platform": "API"
}'

Respuesta

response.json

{
"id": 123,
"username": "usuario@ejemplo.com",
"email": "usuario@ejemplo.com",
"first_name": "Juan",
"last_name": 
"Pérez"}

Errores Posibles

Código	Error	Descripción
400	InvalidReferrer	Código de referido inválido
400	ProfileAlreadyReferred	El perfil ya tiene un referido asignado
404	ReferalCodeNotExist	El código de referido no existe
400	TypePersonRequired	Tipo de persona requerido
400	InfoBusinessDoesNotExist	Información de negocio no existe
400	IntegrationException	Error en integración externa

Tipos de Persona: 1 = NATURAL, 2 = JURIDICAL. Para personas jurídicas el campo country_company_incorporation es obligatorio.

⚠️

El sistema valida que no existan duplicados (email, username, teléfono, documento). Username debe ser email válido en PANEL/API.

Siguiente paso

Una vez creado el usuario, procede a verificar su email y teléfono:

Cómo registrar un usuario Verificar email