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-PUBLIC-KEYstring

Tu llave pública de API

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

idstringOptional

ID único del cliente

user_idstringOptional

ID del usuario asociado

emailstringOptionalformat: "email"

Email del cliente

namestringOptional

Nombre del cliente

phonestring or nullOptional

Número de teléfono

addressstring or nullOptional

Dirección

nitstring or nullOptional

Número de identificación tributaria

metadatamap from strings to any or nullOptional

Metadata personalizada

Errors

400

Bad Request Error

$	curl -X POST https://app.recurrente.com/api/customers \
>	-H "X-PUBLIC-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	}