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}

Retrieve an account token v2

GET / v2 / core / account_tokens /:id

Retrieves an Account Token.