---
title: "Create a person associated with an originator"
method: POST
path: "/transfer/platform/person/create"
tags: ["plaid"]
---

# Create a person associated with an originator

`POST /transfer/platform/person/create`

Use the `/transfer/platform/person/create` endpoint to create a person associated with an originator (e.g. beneficial owner or control person) and optionally submit personal identification information for them.

## Request body

- TransferPlatformPersonCreateRequest — Defines the request schema for `/transfer/platform/person/create`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `originator_client_id` string, required — The client ID of the originator
  - `name` TransferPlatformPersonName — The person's legal name
    - `given_name` string, required — A string with at least one non-whitespace character, with a max length of 100 characters.
    - `family_name` string, required — A string with at least one non-whitespace character, with a max length of 100 characters.
  - `email_address` string — A valid email address. Must not have leading or trailing spaces.
  - `phone_number` string — A valid phone number in E.164 format. Phone number input may be validated against valid number ranges; number strings that do not match a real-world phone numbering scheme may cause the request to fail, even in the Sandbox test environment.
  - `address` TransferPlatformPersonAddress — Home address of a person
    - `city` string, required — The full city name.
    - `country` string, required — Valid, capitalized, two-letter ISO code representing the country of this object. Must be in ISO 3166-1 alpha-2 form.
    - `postal_code` string, required — The postal code of the address.
    - `region` string, required — An ISO 3166-2 subdivision code. Related terms would be "state", "province", "prefecture", "zone", "subdivision", etc.
    - `street` string, required — The primary street portion of an address. A string with at least one non-whitespace alphabetical character, with a max length of 80 characters.
    - `street2` string — Extra street information, like an apartment or suite number. If provided, a string with at least one non-whitespace character, with a max length of 50 characters.
  - `id_number` TransferPlatformPersonIDNumber — ID number of the person
    - `value` string, required — Value of the person's ID Number. Alpha-numeric, with all formatting characters stripped.
    - `type` 'ar_dni' | 'au_drivers_license' | 'au_passport' | 'br_cpf' | 'ca_sin' | 'cl_run' | 'cn_resident_card' | 'co_nit' | 'dk_cpr' | 'eg_national_id' | 'es_dni' | 'es_nie' | 'hk_hkid' | 'in_pan' | 'in_epic' | 'it_cf' | 'jo_civil_id' | 'jp_my_number' | 'ke_huduma_namba' | 'kw_civil_id' | 'mx_curp' | 'mx_rfc' | 'my_nric' | 'ng_nin' | 'nz_drivers_license' | 'om_civil_id' | 'ph_psn' | 'pl_pesel' | 'ro_cnp' | 'sa_national_id' | 'se_pin' | 'sg_nric' | 'tr_tc_kimlik' | 'us_ssn' | 'us_ssn_last_4' | 'za_smart_id', required — A globally unique and human readable ID type, specific to the country and document category. For more context on this field, see [Input Validation Rules](https://plaid.com/docs/identity-verification/hybrid-input-validation/#id-numbers).
  - `date_of_birth` string, date — The date of birth of the person. Formatted as YYYY-MM-DD.
  - `relationship_to_originator` string — The relationship between this person and the originator they are related to.
  - `ownership_percentage` integer — The percentage of ownership this person has in the onboarding business. Only applicable to beneficial owners with 25% or more ownership.
  - `title` string — The title of the person at the business. Only applicable to control persons - for example, "CEO", "President", "Owner", etc.

## Response `200`

OK

- TransferPlatformPersonCreateResponse — Defines the response schema for `/transfer/platform/person/create`
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
  - `person_id` string, required — An ID that should be used when submitting additional requirements that are associated with this person.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)