v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Create a person

Creates a new person.

post/v1/accounts/{account}/people

Path parameters

accountstring required

Response

Successful response.

accountstring required

The account the person is associated with.

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

emailstring nullable

The person's email address. Also available for accounts where controller.requirement_collection is stripe.

first_namestring nullable

The person's first name. Also available for accounts where controller.requirement_collection is stripe.

first_name_kanastring nullable

The Kana variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

first_name_kanjistring nullable

The Kanji variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

full_name_aliasesstring[]

A list of alternate names or aliases that the person is known by. Also available for accounts where controller.requirement_collection is stripe.

genderstring nullable

The person's gender.

idstring required

Unique identifier for the object.

id_number_providedboolean

Whether the person's id_number was provided. True if either the full ID number was provided or if only the required part of the ID number was provided (ex. last four of an individual's SSN for the US indicated by ssn_last_4_provided).

id_number_secondary_providedboolean

Whether the person's id_number_secondary was provided.

last_namestring nullable

The person's last name. Also available for accounts where controller.requirement_collection is stripe.

last_name_kanastring nullable

The Kana variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

last_name_kanjistring nullable

The Kanji variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

maiden_namestring nullable

The person's maiden name.

metadataobject

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

nationalitystring nullable

The country where the person is a national.

object'person' required

String representing the object's type. Objects of the same type share the same value.

phonestring nullable

The person's phone number.

political_exposure'existing' | 'none'

Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.

ssn_last_4_providedboolean

Whether the last four digits of the person's Social Security number have been provided (U.S. only).