# Create an account token

Creates a single-use token that wraps a user’s legal entity information. Use this when creating or updating a Connect account. Learn more about [account tokens](https://docs.stripe.com/docs/connect/account-tokens.md).

In live mode, you can only create account tokens with your application’s publishable key. In test mode, you can only create account tokens with your secret key or publishable key.

## Returns

Returns the created account token if it’s successful. Otherwise, this call raises [an error](https://docs.stripe.com/api/tokens/create_account.md#errors).

## Parameters

- `account` (object, required)
  Information for the account this token represents.

  - `account.business_type` (enum, optional)
    The business type.
Possible enum values:
    - `company`
    - `government_entity`
      US only

    - `individual`
    - `non_profit`

  - `account.company` (object, optional)
    Information about the company or business.

    - `account.company.address` (object, optional)
      The company’s primary address.

      - `account.company.address.city` (string, optional)
        City, district, suburb, town, or village.

      - `account.company.address.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.company.address.line1` (string, optional)
        Address line 1 (e.g., street, PO Box, or company name).

      - `account.company.address.line2` (string, optional)
        Address line 2 (e.g., apartment, suite, unit, or building).

      - `account.company.address.postal_code` (string, optional)
        ZIP or postal code.

      - `account.company.address.state` (string, optional)
        State, county, province, or region.

    - `account.company.address_kana` (object, optional)
      The Kana variation of the company’s primary address (Japan only).

      - `account.company.address_kana.city` (string, optional)
        City or ward.

      - `account.company.address_kana.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.company.address_kana.line1` (string, optional)
        Block or building number.

      - `account.company.address_kana.line2` (string, optional)
        Building details.

      - `account.company.address_kana.postal_code` (string, optional)
        Postal code.

      - `account.company.address_kana.state` (string, optional)
        Prefecture.

      - `account.company.address_kana.town` (string, optional)
        Town or cho-me.

    - `account.company.address_kanji` (object, optional)
      The Kanji variation of the company’s primary address (Japan only).

      - `account.company.address_kanji.city` (string, optional)
        City or ward.

      - `account.company.address_kanji.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.company.address_kanji.line1` (string, optional)
        Block or building number.

      - `account.company.address_kanji.line2` (string, optional)
        Building details.

      - `account.company.address_kanji.postal_code` (string, optional)
        Postal code.

      - `account.company.address_kanji.state` (string, optional)
        Prefecture.

      - `account.company.address_kanji.town` (string, optional)
        Town or cho-me.

    - `account.company.directors_provided` (boolean, optional)
      Whether the company’s directors have been provided. Set this Boolean to `true` after creating all the company’s directors with [the Persons API](https://docs.stripe.com/api/persons.md) for accounts with a `relationship.director` requirement. This value is not automatically set to `true` after creating directors, so it needs to be updated to indicate all directors have been provided.

    - `account.company.directorship_declaration` (object, optional)
      This hash is used to attest that the directors information provided to Stripe is both current and correct.

      - `account.company.directorship_declaration.date` (timestamp, optional)
        The Unix timestamp marking when the directorship declaration attestation was made.

      - `account.company.directorship_declaration.ip` (string, optional)
        The IP address from which the directorship declaration attestation was made.

      - `account.company.directorship_declaration.user_agent` (string, optional)
        The user agent of the browser from which the directorship declaration attestation was made.

    - `account.company.executives_provided` (boolean, optional)
      Whether the company’s executives have been provided. Set this Boolean to `true` after creating all the company’s executives with [the Persons API](https://docs.stripe.com/api/persons.md) for accounts with a `relationship.executive` requirement.

    - `account.company.export_license_id` (string, optional)
      The export license ID number of the company, also referred as Import Export Code (India only).

    - `account.company.export_purpose_code` (string, optional)
      The purpose code to use for export transactions (India only).

    - `account.company.name` (string, optional)
      The company’s legal name.

    - `account.company.name_kana` (string, optional)
      The Kana variation of the company’s legal name (Japan only).

    - `account.company.name_kanji` (string, optional)
      The Kanji variation of the company’s legal name (Japan only).

    - `account.company.owners_provided` (boolean, optional)
      Whether the company’s owners have been provided. Set this Boolean to `true` after creating all the company’s owners with [the Persons API](https://docs.stripe.com/api/persons.md) for accounts with a `relationship.owner` requirement.

    - `account.company.ownership_declaration` (object, optional)
      This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct.

      - `account.company.ownership_declaration.date` (timestamp, optional)
        The Unix timestamp marking when the beneficial owner attestation was made.

      - `account.company.ownership_declaration.ip` (string, optional)
        The IP address from which the beneficial owner attestation was made.

      - `account.company.ownership_declaration.user_agent` (string, optional)
        The user agent of the browser from which the beneficial owner attestation was made.

    - `account.company.ownership_declaration_shown_and_signed` (boolean, optional)
      Whether the user described by the data in the token has been shown the Ownership Declaration and indicated that it is correct.

    - `account.company.ownership_exemption_reason` (enum, optional)
      This value is used to determine if a business is exempt from providing ultimate beneficial owners. See [this support article](https://support.stripe.com/questions/exemption-from-providing-ownership-details) and [changelog](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api.md) for more details.

    - `account.company.phone` (string, optional)
      The company’s phone number (used for verification).

    - `account.company.registration_number` (string, optional)
      The identification number given to a company when it is registered or incorporated, if distinct from the identification number used for filing taxes. (Examples are the CIN for companies and LLP IN for partnerships in India, and the Company Registration Number in Hong Kong).

    - `account.company.structure` (enum, optional)
      The category identifying the legal structure of the company or legal entity. See [Business structure](https://docs.stripe.com/connect/identity-verification.md#business-structure) for more details. Pass an empty string to unset this value.

    - `account.company.tax_id` (string, optional)
      The business ID number of the company, as appropriate for the company’s country. (Examples are an Employer ID Number in the U.S., a Business Number in Canada, or a Company Number in the UK.)

    - `account.company.tax_id_registrar` (string, optional)
      The jurisdiction in which the `tax_id` is registered (Germany-based companies only).

    - `account.company.vat_id` (string, optional)
      The VAT number of the company.

    - `account.company.verification` (object, optional)
      Information on the verification state of the company.

      - `account.company.verification.document` (object, optional)
        A document verifying the business.

        - `account.company.verification.document.back` (string, optional)
          The back of a document returned by a [file upload](https://docs.stripe.com/api/tokens/create_account.md#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

        - `account.company.verification.document.front` (string, optional)
          The front of a document returned by a [file upload](https://docs.stripe.com/api/tokens/create_account.md#create_file) with a `purpose` value of `additional_verification`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

  - `account.individual` (object, optional)
    Information about the person represented by the account.

    - `account.individual.address` (object, optional)
      The individual’s primary address.

      - `account.individual.address.city` (string, optional)
        City, district, suburb, town, or village.

      - `account.individual.address.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.individual.address.line1` (string, optional)
        Address line 1 (e.g., street, PO Box, or company name).

      - `account.individual.address.line2` (string, optional)
        Address line 2 (e.g., apartment, suite, unit, or building).

      - `account.individual.address.postal_code` (string, optional)
        ZIP or postal code.

      - `account.individual.address.state` (string, optional)
        State, county, province, or region.

    - `account.individual.address_kana` (object, optional)
      The Kana variation of the individual’s primary address (Japan only).

      - `account.individual.address_kana.city` (string, optional)
        City or ward.

      - `account.individual.address_kana.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.individual.address_kana.line1` (string, optional)
        Block or building number.

      - `account.individual.address_kana.line2` (string, optional)
        Building details.

      - `account.individual.address_kana.postal_code` (string, optional)
        Postal code.

      - `account.individual.address_kana.state` (string, optional)
        Prefecture.

      - `account.individual.address_kana.town` (string, optional)
        Town or cho-me.

    - `account.individual.address_kanji` (object, optional)
      The Kanji variation of the individual’s primary address (Japan only).

      - `account.individual.address_kanji.city` (string, optional)
        City or ward.

      - `account.individual.address_kanji.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.individual.address_kanji.line1` (string, optional)
        Block or building number.

      - `account.individual.address_kanji.line2` (string, optional)
        Building details.

      - `account.individual.address_kanji.postal_code` (string, optional)
        Postal code.

      - `account.individual.address_kanji.state` (string, optional)
        Prefecture.

      - `account.individual.address_kanji.town` (string, optional)
        Town or cho-me.

    - `account.individual.dob` (object, optional)
      The individual’s date of birth.

      - `account.individual.dob.day` (integer, required)
        The day of birth, between 1 and 31.

      - `account.individual.dob.month` (integer, required)
        The month of birth, between 1 and 12.

      - `account.individual.dob.year` (integer, required)
        The four-digit year of birth.

    - `account.individual.email` (string, optional)
      The individual’s email address.

    - `account.individual.first_name` (string, optional)
      The individual’s first name.

    - `account.individual.first_name_kana` (string, optional)
      The Kana variation of the individual’s first name (Japan only).

    - `account.individual.first_name_kanji` (string, optional)
      The Kanji variation of the individual’s first name (Japan only).

    - `account.individual.full_name_aliases` (array of strings, optional)
      A list of alternate names or aliases that the individual is known by.

    - `account.individual.gender` (enum, optional)
      The individual’s gender

    - `account.individual.id_number` (string, optional)
      The government-issued ID number of the individual, as appropriate for the representative’s country. (Examples are a Social Security Number in the U.S., or a Social Insurance Number in Canada). Instead of the number itself, you can also provide a [PII token created with Stripe.js](https://docs.stripe.com/js/tokens/create_token?type=pii).

    - `account.individual.id_number_secondary` (string, optional)
      The government-issued secondary ID number of the individual, as appropriate for the representative’s 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 created with Stripe.js](https://docs.stripe.com/js/tokens/create_token?type=pii).

    - `account.individual.last_name` (string, optional)
      The individual’s last name.

    - `account.individual.last_name_kana` (string, optional)
      The Kana variation of the individual’s last name (Japan only).

    - `account.individual.last_name_kanji` (string, optional)
      The Kanji variation of the individual’s last name (Japan only).

    - `account.individual.maiden_name` (string, optional)
      The individual’s maiden name.

    - `account.individual.metadata` (object, optional)
      Set of [key-value pairs](https://docs.stripe.com/docs/api/metadata.md) 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`.

    - `account.individual.phone` (string, optional)
      The individual’s phone number.

    - `account.individual.political_exposure` (enum, optional)
      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.
Possible enum values:
      - `existing`
        The person has disclosed that they do have political exposure

      - `none`
        The person has disclosed that they have no political exposure

    - `account.individual.registered_address` (object, optional)
      The individual’s registered address.

      - `account.individual.registered_address.city` (string, optional)
        City, district, suburb, town, or village.

      - `account.individual.registered_address.country` (string, optional)
        Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).

      - `account.individual.registered_address.line1` (string, optional)
        Address line 1 (e.g., street, PO Box, or company name).

      - `account.individual.registered_address.line2` (string, optional)
        Address line 2 (e.g., apartment, suite, unit, or building).

      - `account.individual.registered_address.postal_code` (string, optional)
        ZIP or postal code.

      - `account.individual.registered_address.state` (string, optional)
        State, county, province, or region.

    - `account.individual.relationship` (object, optional)
      Describes the person’s relationship to the account.

      - `account.individual.relationship.director` (boolean, optional)
        Whether the person is a director of the account’s legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.

      - `account.individual.relationship.executive` (boolean, optional)
        Whether the person has significant responsibility to control, manage, or direct the organization.

      - `account.individual.relationship.owner` (boolean, optional)
        Whether the person is an owner of the account’s legal entity.

      - `account.individual.relationship.percent_ownership` (float, optional)
        The percent owned by the person of the account’s legal entity.

      - `account.individual.relationship.title` (string, optional)
        The person’s title (e.g., CEO, Support Engineer).

    - `account.individual.ssn_last_4` (string, optional)
      The last four digits of the individual’s Social Security Number (U.S. only).

    - `account.individual.verification` (object, optional)
      The individual’s verification document information.

      - `account.individual.verification.additional_document` (object, optional)
        A document showing address, either a passport, local ID card, or utility bill from a well-known utility company.

        - `account.individual.verification.additional_document.back` (string, optional)
          The back of an ID returned by a [file upload](https://docs.stripe.com/api/tokens/create_account.md#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

        - `account.individual.verification.additional_document.front` (string, optional)
          The front of an ID returned by a [file upload](https://docs.stripe.com/api/tokens/create_account.md#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

      - `account.individual.verification.document` (object, optional)
        An identifying document, either a passport or local ID card.

        - `account.individual.verification.document.back` (string, optional)
          The back of an ID returned by a [file upload](https://docs.stripe.com/api/tokens/create_account.md#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

        - `account.individual.verification.document.front` (string, optional)
          The front of an ID returned by a [file upload](https://docs.stripe.com/api/tokens/create_account.md#create_file) with a `purpose` value of `identity_document`. The uploaded file needs to be a color image (smaller than 8,000px by 8,000px), in JPG, PNG, or PDF format, and less than 10 MB in size.

  - `account.tos_shown_and_accepted` (boolean, optional)
    Whether the user described by the data in the token has been shown [the Stripe Connected Account Agreement](https://docs.stripe.com/connect/account-tokens.md#stripe-connected-account-agreement). When creating an account token to create a new Connect account, this value must be `true`.

```curl
curl https://api.stripe.com/v1/tokens \
  -u "<<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d "account[business_type]"=individual \
  -d "account[individual][first_name]"=Jane \
  -d "account[individual][last_name]"=Doe \
  -d "account[tos_shown_and_accepted]"=true
```

### Response

```json
{
  "id": "ct_1BZ6xr2eZvKYlo2CsSOhuTfi",
  "object": "token",
  "client_ip": "104.198.25.169",
  "created": 1513297331,
  "livemode": false,
  "redaction": null,
  "type": "account",
  "used": false
}
```