--- title: "Create Entity (Banking Connectivity)" method: POST path: "/banking/entities" tags: ["Entities (Banking Connectivity)"] --- # Create Entity (Banking Connectivity) `POST /banking/entities` ## Headers - `x-idempotency-key` string, required ## Request body - object - `account_id` string, required — The unique identifier of the merchant's Yuno account. Found on the [Yuno dashboard](https://dashboard.y.uno/) (UUID, 36 characters). - `merchant_entity_id` string, required — The merchant's own identifier for this entity, used for reconciliation. - `national_entity` 'INDIVIDUAL' | 'ENTITY', required — The type of entity being created. - `phone` object, required — The entity's phone number. - `country_code` string, required — The phone country code (e.g., `+1`). - `number` string, required — The phone number without the country code. - `address` object, required — The entity's primary address. - `address_line_1` string, required — The primary street address. - `address_line_2` string, nullable — The secondary address line (apartment, suite, etc.). - `building_number_1` string, nullable — The primary building number. - `building_number_2` string, nullable — The secondary building number. - `city` string, required — The city name. - `state` string, required — The state or province. - `zip_code` string, required — The postal or ZIP code. - `country` string, required — The country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `entity_detail` object, required — The detailed information for the entity. Provide either `individual` or `entity` based on the `national_entity` value. - `individual` object, nullable — Individual person details. Required when `national_entity` is `INDIVIDUAL`. - `first_name` string — The individual's first name. - `last_name` string — The individual's last name. - `email` string — The individual's email address. - `date_of_birth` string — The date of birth (YYYY-MM-DD). - `gender` 'M' | 'F' — The individual's gender. - `country_of_residence` string — The country of residence ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `tax_information` object[] — Tax identification records for the individual. - `country` string, required — The tax jurisdiction country code. - `tax_id` string, required — The tax identification number. - `tax_id_type` 'SSN' | 'EIN' | 'ITIN' | 'VAT' | 'ABN' | 'NIF' | 'TIN' | 'OTHER', required — The type of tax identification. - `is_primary` boolean, required — Whether this is the primary tax residency. - `document` object — The primary identification document. - `document_type` string, required — The type of identity document. - `document_number` string, required — The document number. - `issuing_country` string, required — The country that issued the document ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `issued_at` string, nullable — The date the document was issued (YYYY-MM-DD). - `expires_at` string, nullable — The document expiration date (YYYY-MM-DD). - `entity` object, nullable — Business or organization details. Required when `national_entity` is `ENTITY`. - `name` string — The business or organization name. - `country` string — The country of incorporation ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `tax_information` object[] — Business tax identification records. - `country` string, required — The tax jurisdiction country code. - `tax_id` string, required — The tax identification number. - `tax_id_type` 'SSN' | 'EIN' | 'ITIN' | 'VAT' | 'ABN' | 'NIF' | 'TIN' | 'OTHER', required — The type of tax identification. - `is_primary` boolean, required — Whether this is the primary tax residency. - `entity_type` 'CORPORATION' — The type of business entity. - `beneficial_owners` object[] — The beneficial owners of the business entity. - `first_name` string, required — The owner's first name. - `last_name` string, required — The owner's last name. - `email` string, required — The owner's email address. - `date_of_birth` string, required — The owner's date of birth (YYYY-MM-DD). - `gender` 'M' | 'F' — The owner's gender. - `country_of_residence` string, required — The owner's country of residence ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `tax_information` object[] — Tax identification records for the owner. - `country` string — The tax jurisdiction country code. - `tax_id` string — The tax identification number. - `tax_id_type` 'SSN' | 'EIN' | 'ITIN' | 'VAT' | 'ABN' | 'NIF' | 'TIN' | 'OTHER' — The type of tax identification. - `is_primary` boolean — Whether this is the primary tax residency. - `document` object — The owner's primary identification document. - `document_type` string — The type of identity document. - `document_number` string — The document number. - `issuing_country` string — The country that issued the document. - `issued_at` string, nullable — The date the document was issued (YYYY-MM-DD). - `expires_at` string, nullable — The document expiration date (YYYY-MM-DD). - `ownership_percentage` number, required — The percentage of ownership in the business (0-100). - `title` string — The owner's title or role in the organization. - `address` object — The owner's residential address. - `address_line_1` string — The primary street address. - `address_line_2` string, nullable — The secondary address line. - `building_number_1` string, nullable — The primary building number. - `building_number_2` string, nullable — The secondary building number. - `city` string — The city name. - `state` string — The state or province. - `zip_code` string — The postal or ZIP code. - `country` string — The country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). ## Response `201` Created (Individual) - object - `id` string - `account_id` string - `merchant_entity_id` string - `national_entity` string - `phone` object - `country_code` string - `number` string - `address` object - `address_line_1` string - `address_line_2` unknown - `building_number_1` string - `building_number_2` unknown - `city` string - `state` string - `zip_code` string - `country` string - `entity_detail` object - `individual` unknown - `entity` object - `name` string - `country` string - `tax_information` object[] - `country` string - `tax_id_last_4` string - `tax_id_type` string - `is_primary` boolean - `entity_type` string - `beneficial_owners` object[] - `first_name` string - `last_name` string - `email` string - `date_of_birth` string - `gender` string - `country_of_residence` string - `tax_information` object[] - `country` string - `tax_id_last_4` string - `tax_id_type` string - `is_primary` boolean - `document` object - `document_type` string - `document_number_last_4` string - `issuing_country` string - `issued_at` string - `expires_at` unknown - `ownership_percentage` integer - `title` string - `address` object - `address_line_1` string - `address_line_2` unknown - `building_number_1` string - `building_number_2` unknown - `city` string - `state` string - `zip_code` string - `country` string - `created_at` string - `updated_at` string ## Other responses - `400` — Bad Request - `409` — Conflict --- [API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)