Saltar al contenido principal
POST
Crea una entidad de Yuno que representa a una persona o a una organización. Define entity_type como INDIVIDUAL o BUSINESS y proporciona el sub-objeto entity_detail correspondiente. Consulta Entity types para más detalles. Los campos sensibles como tax_id y document_number se enmascaran en las respuestas (por ejemplo *******6789).

Autorizaciones

public-api-key
string
header
requerido
private-secret-key
string
header
requerido

Encabezados

x-idempotency-key
string
requerido

Identificador único que se usa en los encabezados HTTP para asegurar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o tiempos de espera agotados. Consulta autenticación para ver los detalles (UUID).

Cuerpo

application/json
account_id
string
requerido

El identificador único de la cuenta de Yuno del comercio. Lo encuentras en el Dashboard de Yuno (UUID, 36 caracteres).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

merchant_entity_id
string
requerido

El identificador propio del comercio para esta entidad, que se usa para la conciliación.

Ejemplo:

"merchant_user_12345"

entity_type
enum<string>
requerido

El tipo de entidad que se crea.

Opciones disponibles:
INDIVIDUAL,
BUSINESS
Ejemplo:

"INDIVIDUAL"

phone
object
requerido

El número de teléfono de la entidad.

address
object
requerido

La dirección principal de la entidad.

entity_detail
object
requerido

La información detallada de la entidad. Envía individual o business según el valor de entity_type.

Respuesta

Creado (individuo)

id
string
Ejemplo:

"770e8400-e29b-41d4-a716-446655440000"

account_id
string
Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

merchant_entity_id
string
Ejemplo:

"merchant_company_789"

entity_type
string
Ejemplo:

"BUSINESS"

phone
object
address
object
entity_detail
object
created_at
string
Ejemplo:

"2026-02-01T10:00:00Z"

updated_at
string
Ejemplo:

"2026-02-01T10:00:00Z"