Account Tokens v2

Account tokens are single-use tokens which tokenize an account’s contact_email, display_name, contact_phone, and identity.

Learn more about calling API v2 endpoints.

Was this section helpful? Yes No

Create an account token

POST / v2 / core / account_tokens

Retrieve an account token

GET / v2 / core / account_tokens /:id

The Account Token object v2

Attributes

id string Unique identifier for the token.
object string, value is "v2.core.account_token" String representing the object’s type. Objects of the same type share the same value of the object field.
created timestamp Time at which the token was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
expires _ at timestamp Time at which the token will expire.
livemode boolean Has the value true if the token exists in live mode or the value false if the object exists in test mode.
used boolean Determines if the token has already been used (tokens can only be used once).

The Account Token object

{ "id": "accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY", "object": "v2.core.account_token", "created": "2025-11-17T14:00:00.000Z", "expires_at": "2025-11-17T14:10:00.000Z", "livemode": true, "used": false}

Create an account token v2

POST / v2 / core / account_tokens

Create an account token with a publishable key and pass it to the Accounts v2 API to create or update an account without its data touching your server. 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 create account tokens with your secret key or publishable key.

Learn more about calling API v2 endpoints.

Parameters

contact _ email string The primary contact email address for the Account.
contact _ phone string The default contact phone for the Account.
display _ name string A descriptive name for the Account. This name will be surfaced in the Stripe Dashboard and on any invoices sent to the Account.
identity object Information about the company, individual, and business represented by the Account.

Returns

Returns an Account Token object.

Error Codes

400 non _ connect _ platform _ accounts _ v2 _ access _ blocked

Needs to use the newer API version or onboard to Connect.

400 platform _ registration _ required

The direct merchant has not signed up for Connect and cannot create connected accounts.

400 token _ must _ be _ created _ with _ publishable _ key

Token must be created with publishable key.

429 account _ rate _ limit _ exceeded

Account cannot exceed a configured concurrency rate limit on updates.

Response

{ "id": "accttok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY", "object": "v2.core.account_token", "created": "2025-11-17T14:00:00.000Z", "expires_at": "2025-11-17T14:10:00.000Z", "livemode": true, "used": false}