Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

Create a person token


Create a person token

POST / v1 / tokens

Creates a single-use token that represents the details for a person. Use this when you create or update persons associated with a Connect account. Learn more about account tokens.

You can only create person tokens with your application’s publishable key and in live mode. You can use your application’s secret key to create person tokens only in test mode.

Parameters

  • person object Required Information for the person this token represents.

Returns

Returns the created person token if it’s successful. Otherwise, this call raises an error.

Response

{ "id": "cpt_1EDww82eZvKYlo2CsdelTHFu", "object": "token", "client_ip": "8.21.168.117", "created": 1552582904, "livemode": false, "redaction": null, "type": "person", "used": false}

Create a PII token

POST / v1 / tokens

Creates a single-use token that represents the details of personally identifiable information (PII). You can use this token in place of an id_number or id_number_secondary in Account or Person Update API methods. You can only use a PII token once.

Parameters

  • pii object Required The PII this token represents.

Returns

Returns the created PII token if it’s successful. Otherwise, this call raises an error.

Response

{ "id": "pii_18PwbX2eZvKYlo2CzRXgwN3J", "object": "token", "client_ip": "124.123.76.134", "created": 1466783547, "livemode": false, "redaction": null, "type": "pii", "used": false}

Create an account token

POST / v1 / tokens

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.

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.

Parameters

  • account object Required Information for the account this token represents.

Returns

Returns the created account token if it’s successful. Otherwise, this call raises an error.

Response

{ "id": "ct_1BZ6xr2eZvKYlo2CsSOhuTfi", "object": "token", "client_ip": "104.198.25.169", "created": 1513297331, "livemode": false, "redaction": null, "type": "account", "used": false}
Last verified 2026-09-25

Is this helpful?