Skip to main content
POST
Create an entity

Authorizations

Authorization
string
header
required

Body

application/json
country_code
string
required

ISO 3166-1 alpha-2 country code of the entity. In Mexico, the country_code value determines which holder_id values Fintoc accepts: use MX for Mexican entities, or another code, such as US, for foreign entities. In Chile, country_code does not change the holder_id requirements.

Example:

"MX"

holder_name
string
required

Legal name of the entity owner.

Example:

"Test Entity 1"

holder_id
string

Tax identifier of the entity owner. In Chile, use a Chilean tax ID (RUT). This field is always required in Chile, regardless of country_code. In Mexico, use a Mexican tax ID (RFC) without dots or hyphens when country_code is MX. For foreign entities in Mexico, omit this field or send the generic foreign RFC XEXX010101000; Fintoc rejects any other value. The value must be unique within your organization, except XEXX010101000, which can repeat across foreign entities in Mexico.

Example:

"AAA010101AAA"

Response

The created entity.

id
string
required

Unique identifier of the entity.

Example:

"ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
required

Type of the object. Always entity.

capabilities
object
required

Statuses for the entity's capabilities. A capability is a role the entity can take in Fintoc, such as holding accounts or receiving settlements. Each capability has its own onboarding, so the statuses can differ.

country_code
string | null
required

ISO 3166-1 alpha-2 country code of the entity, in lowercase, or null when not set. For example, cl or mx.

Example:

"mx"

holder_id
string
required

Mexican tax ID (RFC) of the entity owner, without dots or hyphens. For a foreign entity, the value is the generic foreign RFC XEXX010101000.

Example:

"AAA010101AAA"

holder_name
string
required

Legal name of the entity owner.

Example:

"Test Entity 1"

is_root
boolean
required

Whether this entity is your organization's root entity.

Example:

true

mode
enum<string>
required

Whether the entity belongs to live or test data. One of live or test.

Available options:
live,
test
Example:

"test"

status
enum<string>
required

Overall status of the entity. The value is operational when any capability is operational. Otherwise, the value matches the account_holder capability status. Use capabilities to check each capability on its own. One of draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, or paused.

Available options:
draft,
under_review,
pending_signature,
canceled,
waiting_initialization,
operational,
rejected,
paused
Example:

"operational"