Creates a third-party account holder

post

https://api.sandbox.cuentamono.com/v1/ledger/account_holders

Creates a new third-party account holder and associates it to the tenant.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Attributes to create a third-party account holder

An account holder is a natural or legal person that has a ledger account.

address

object

required

Contains the address information related to the account holder.

string | null

^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+){1,2}$

Account holder's email

external_id

string | null

required

Represents a unique external_id generated and provided by the API user. The API user is responsible to generate and provide a unique id for all their organization's account holders.

metadata

object | null

A tenant-managed flat map for providing additional data about the account holder. The values are stored and displayed as strings, and the provided information will be returned as-is in the account holder details.

person

object

required

Contains the specific person information of the account holder.

phone_number

string | null

^\+[1-9]\d{1,14}$

Account holder's phone number

Headers

x-idempotency-key

uuid

Idempotency key in UUID format

Responses

Callback

200Successful response when it finds the request with the same idempotency key

201Successful response

400400 Bad Request

401401 Unauthorized

403403 Forbidden

422422 Unprocessable Content