Crear un cliente | Documentación API de Recurrente

Crea un nuevo cliente. Si ya existe un usuario con el email proporcionado, el cliente se asocia a ese usuario. Si el email es nuevo, se crean tanto el usuario como el cliente.

Authentication

X-SECRET-KEYstring

Tu llave secreta de API

Request

This endpoint expects an object.

emailstringRequiredformat: "email"

Email del cliente (se usa para buscar o crear el usuario)

full_namestringOptional

Nombre completo

namestringOptional

Nombre para mostrar

phonestringOptional

(Opcional) Número de teléfono

addressstringOptional

(Opcional) Dirección

nitstringOptional

(Opcional) Número de identificación tributaria

metadatamap from strings to stringsOptional

(Opcional) Metadata personalizada

Response

Cliente creado o encontrado

idstring

ID único del cliente

user_idstring

ID del usuario asociado

emailstringformat: "email"

Email del cliente

namestring

Nombre del cliente

phonestring or null

Número de teléfono

addressstring or null

Dirección

nitstring or null

Número de identificación tributaria

metadatamap from strings to any or null

Metadata personalizada

Errors

400

Bad Request Error

Tu llave secreta de API

This endpoint expects an object.

Email del cliente (se usa para buscar o crear el usuario)

(Opcional) Número de teléfono

(Opcional) Dirección

(Opcional) Número de identificación tributaria

(Opcional) Metadata personalizada

Cliente creado o encontrado

ID único del cliente

ID del usuario asociado

Número de teléfono

Número de identificación tributaria

Metadata personalizada

$	curl -X POST https://app.recurrente.com/api/customers \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"email": "nuevo@ejemplo.com"
>	}'

1	{
2	"id": "cus_abc123",
3	"user_id": "usr_xyz789",
4	"email": "cliente@ejemplo.com",
5	"name": "Maria Garcia",
6	"phone": "string",
7	"address": "string",
8	"nit": "string",
9	"metadata": {}
10	}

$	curl -X POST https://app.recurrente.com/api/customers \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"email": "nuevo@ejemplo.com"
>	}'

1	{
2	"id": "cus_abc123",
3	"user_id": "usr_xyz789",
4	"email": "cliente@ejemplo.com",
5	"name": "Maria Garcia",
6	"phone": "string",
7	"address": "string",
8	"nit": "string",
9	"metadata": {}
10	}