Create company customer
Entorno sandbox
https://sandbox.cryptopocket.io/api
Entorno sandbox
https://sandbox.cryptopocket.io/api
POST
/register/company
Summary
Description
auth header.kyb_link and password to complete corporate verification (Know Your Business) through the onboarding form.auth header.Headers
| Header | Type | Required | Description |
|---|---|---|---|
auth | string | Yes | Integration authentication token |
Content-Type | string | Yes | application/json |
Request Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Company contact email. Max 254 characters. Must be a valid email format. |
company_name | string | Yes | Legal or commercial name of the company. Max 255 characters. |
Example Request
{
"email": "contact@acmecorp.com",
"company_name": "Acme Corporation S.L."
}Success Response (200 OK)
{
"status": "ok",
"data": {
"id": 1234,
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"kyb_link": "https://b2b.example.com/kyb/550e8400-e29b-41d4-a716-446655440000",
"password": "xK9mP2nQ4rTv"
}
}Response fields
| Field | Type | Description |
|---|---|---|
id | integer | Internal user ID of the created company |
uuid | string | Public UUID of the company user |
kyb_link | string | Public URL to access the KYB onboarding form |
password | string | Access password for the KYB form (12 characters, auto-generated) |
Note: Store kyb_linkandpasswordsecurely. They are required to complete the KYB process. The link expires 90 days after creation.
Error Responses
Authentication error
{
"status": "error",
"error": "authorization_incorrect"
}Email already registered
{
"status": "error",
"error": "user_already_exists"
}Disposable email not allowed
{
"status": "error",
"error": "email_not_allowed"
}Validation error (422)
{
"message": "The email field is required. (and 1 more error)",
"errors": {
"email": ["The email field is required."],
"company_name": ["The company name field is required."]
}
}Internal error
{
"status": "error",
"error": "unexpected_error"
}Error codes
| Error code | HTTP Status | Description |
|---|---|---|
authorization_incorrect | 200 | Invalid or missing authentication token |
user_already_exists | 200 | A user with this email is already registered |
email_not_allowed | 200 | Email uses a disposable/temporary domain |
unexpected_error | 200 | Internal server error |
| Validation errors | 422 | Missing or invalid email / company_name |
Business flow
Integration API Platform
| |
| POST /register/company |
|--------------------------->|
| | Create company user
| | Create KYB record (draft)
| | Generate KYB link (90 days)
| { kyb_link, password } |
|<---------------------------|
| |
| Share link + password |
| with the company |
| |
| Company completes KYB |
| form via kyb_link |
|--------------------------->|Solicitud
Parámetros de Header
Parámetros del Body application/json
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.cryptopocket.io/api/register/company' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "contact@acmecorp.com",
"company_name": "Acme Corporation S.L."
}'Respuesta Ejemplo de Respuesta
{
"status": "ok",
"data": {
"id": 1234,
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"kyb_link": "https://b2b.example.com/kyb/550e8400-e29b-41d4-a716-446655440000",
"password": "xK9mP2nQ4rTv"
}
}Modificado en 2026-06-26 01:40:22