/v1/accounts/{account}/personsCreate a person associated with an account
Creates a new person associated with the account's legal entity. Supply personal details such as name, address, date of birth, and relationship to the account. All fields are optional, allowing flexible creation of person records with varying levels of detail.
- IdempotentThe SDK sends
Idempotency-Key, so a retried request is only applied once.
The unique identifier of the account to associate the new person with.
Person details. All fields are optional.
Details on the legal guardian's or authorizer's acceptance of the required Stripe agreements.
The person's address.
The Kana variation of the person's address (Japan only).
The Kanji variation of the person's address (Japan only).
The person's date of birth.
Documents that may be submitted to satisfy various informational requests.
The person's email address.
Specifies which fields in the response should be expanded.
The person's first name.
The Kana variation of the person's first name (Japan only).
The Kanji variation of the person's first name (Japan only).
A list of alternate names or aliases that the person is known by.
The person's gender (International regulations require either "male" or "female").
The person's ID number, as appropriate for their country. For example, a social security number in the U.S., social insurance number in Canada, etc. Instead of the number itself, you can also provide a PII token provided by Stripe.js.
Changing this value for the account's representative requires that the account re-accept the terms of service.
The person's secondary ID number, as appropriate for their country, will be used for enhanced verification checks. In Thailand, this would be the laser code found on the back of an ID card. Instead of the number itself, you can also provide a PII token provided by Stripe.js.
Changing this value for the account's representative requires that the account re-accept the terms of service.
The person's last name.
The Kana variation of the person's last name (Japan only).
The Kanji variation of the person's last name (Japan only).
The person's maiden name.
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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.
The country where the person is a national. Two-letter country code (ISO 3166-1 alpha-2), or "XX" if unavailable.
A person token, used to securely provide details to the person.
The person's phone number.
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.
The person's registered address.
The relationship that this person has with the account's legal entity.
The last four digits of the person's Social Security number (U.S. only).
Changing this value for the account's representative requires that the account re-accept the terms of service.
Demographic data related to the person.
The person's verification status.
The account the person is associated with.
Time at which the object was created. Measured in seconds since the Unix epoch.
The person's email address. Also available for accounts where controller.requirement_collection is stripe.
The person's first name. Also available for accounts where controller.requirement_collection is stripe.
The Kana variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
The Kanji variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
A list of alternate names or aliases that the person is known by. Also available for accounts where controller.requirement_collection is stripe.
The person's gender.
Unique identifier for the object.
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).
Whether the person's id_number_secondary was provided.
The person's last name. Also available for accounts where controller.requirement_collection is stripe.
The Kana variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
The Kanji variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.
The person's maiden name.
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.
The country where the person is a national.
String representing the object's type. Objects of the same type share the same value.
The person's phone number.
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.
Whether the last four digits of the person's Social Security number have been provided (U.S. only).
Demographic data related to the person.
account must identify an existing account. When dob is provided, it must include day, month, and year as integers. first_name and last_name must not exceed 5000 characters. gender must be either male or female if provided.