Create Identity

curl --location --request POST '/identities' \ --header 'x-api-key: {{x-api-key}}' \ --header 'User-Agent: ConomyApp/2.1.1' \ --header 'Content-Type: application/json' \ --data-raw '{ "type": "USER", // types: USER, ORGANIZATION "name": "Juan Pérez", "nickname": "juanp", "email": "juan.perez-3@example.com", "phone": "+56912345674", // including +(CountryCode) "documentType": "RUT", // types: RUT, CURP, DNI "documentNumber": "123125", "status": "ACTIVE", // statuses: ACTIVE, PENDING_VALIDATION, BLOCKED "idv": "iv-23123", // "country": "CHL", // ISO 3166-1. ex: CHL, USA, ARG, ESP... "securityOptions": { "twoFactorEnabled": false }, "children": [] }'

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

x-api-key

string

required

Example:

User-Agent

string

required

Example:

ConomyApp/2.1.1

Body Params application/json

type

string

required

name

string

required

nickname

string

required

string

required

phone

string

required

documentType

string

required

documentNumber

string

required

status

string

required

idv

string

required

country

string

required

securityOptions

object

required

twoFactorEnabled

boolean

required

children

array[string]

required

externalId

string

optional

External reference ID (client purpose).

lastname

string

optional

The last name of the user (if applicable).

bankAccount

object | null

optional

A reference to the associated bank account

accountNumber

string

required

The bank account number.

nickname

string

optional

A friendly name assigned to the bank account.

bank

string

required

The name of the bank where the account is held.

currency

string

required

The currency in which the account operates. USD, EUR, CLP, ARS, COP, PER, SOL_USDC

typeAccount

string

optional

The type of bank account. CHECKING_ACOUNT, SAVINGS, ASSET

accountHolder

string

required

The full name of the account holder.

accountHolderDni

string

required

The national identification number or tax ID of the account holder.
he country of operations of the entity

country

string

optional

The country where the bank account is registered. CHL, PER, COL, ARG, MEX, USA, CAD

rules

object

optional

Custom rules or policies applicable to the entity.

Examples

Request

Responses