Create Entity (Banking Connectivity)

post

https://api-sandbox.y.uno/v1/banking/entities

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Create a Yuno entity representing an individual or organization. Set national_entity to INDIVIDUAL or ENTITY and provide the corresponding entity_detail sub-object. See Entity types for details.

Sensitive fields like tax_id and document_number are masked in responses (only last 4 digits returned).

Body Params

account_id

string

required

The unique identifier of the merchant's Yuno account. Found on the Yuno dashboard (UUID, 36 characters).

merchant_entity_id

string

required

The merchant's own identifier for this entity, used for reconciliation.

national_entity

string

enum

required

The type of entity being created.

Allowed:

phone

object

required

The entity's phone number.

address

object

required

The entity's primary address.

entity_detail

object

required

The detailed information for the entity. Provide either individual or entity based on the national_entity value.

Headers

x-idempotency-key

string

required

Unique identifier used in HTTP headers to ensure that a request is processed only once, even if it is retried due to network issues or timeouts. See authentication for details (UUID).

Responses

201Created (Individual)

400Bad Request

409Conflict