User registration

Creates a new user account in the Colurs platform (individual B2C or business B2B). After registration, the system sends a welcome email and the user must verify email and phone.

This endpoint only requires API key, no prior authentication needed.

User Registration

Authorizations

The x-api-key header is required for authorization.

Endpoint

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

Required Headers

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

Request Body

Field	Type	Required	Description
username	string	✓	Valid email for PANEL/API
email	string	✓	Email address
password	string	✓	Password (max 100 chars)
phone	string	✓	Phone without country code
country_code	string	✕	Country code (e.g. 57)
first_name	string	✕	First name
last_name	string	✕	Last name
document_type	string	✕	CC, CE, NIT, PASSPORT
document_number	string	✕	Document number
type_person	int	✓	1 = NATURAL, 2 = JURIDICAL
country_company_incorporation	string	⚠	Required if type_person=2
platform	string	✓	APP or PANEL
country	string	✓	Country code
referal_code	string	✕	Referral code

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"
}

cURL Example

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"
}'

Response

response.json

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

Possible Errors

Code	Error	Description
400	InvalidReferrer	Invalid referral code
400	ProfileAlreadyReferred	Profile already has a referral assigned
404	ReferalCodeNotExist	Referral code does not exist
400	TypePersonRequired	Person type is required
400	InfoBusinessDoesNotExist	Business information does not exist
400	IntegrationException	Integration error

Person types: 1 = NATURAL, 2 = JURIDICAL. For business users, country_company_incorporation is required.

⚠️

The system validates no duplicates exist (email, username, phone, document). Username must be a valid email in PANEL/API.

Next step

Once user is created, proceed to verify email and phone:

How to register a user Verify email