Get B2B Storefront Token | BigCommerce Developer Center

Generates a storefront authToken based on the supplied customerId of a storefront customer or Company user. You can use Get Users to retrieve the IDs of Company users, or you can use Get All Customers to retrieve IDs for B2C customers and B2B buyers alike.

You can also use the BigCommerce Storefront GraphQL API to generate a Customer Access Token (CAT) and include it in the request, but this is not required for a successful response.

The storefront authToken obtained from this endpoint is valid for 1 day.

Generates a storefront authToken based on the supplied `customerId` of a storefront customer or Company user. You can use [Get Users](/developer/api-reference/rest/b2b/management/users) to retrieve the IDs of Company users, or you can use [Get All Customers](/developer/api-reference/rest/admin/management/customers/v3) to retrieve IDs for B2C customers and B2B buyers alike. You can also use the [BigCommerce Storefront GraphQL API](/developer/api-reference/graphql/storefront/authentication#login-mutation) to generate a Customer Access Token (CAT) and include it in the request, but this is not required for a successful response. The storefront authToken obtained from this endpoint is valid for **1 day**.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Request

This endpoint expects an object.

customerIdintegerRequired

The ID of a BigCommerce customer account with a corresponding Company user account.

channelIdintegerOptional

The storefront channel ID where the order was placed.

customerAccessTokenobjectOptional

This object contains information related to the Customer Access Token (CAT) being associated with the storefront authToken.

Response

codeintegerDefaults to 200

The HTTP Status code of the response.

dataobject

metaobject

1	curl -X POST https://api-b2b.bigcommerce.com/api/io/auth/customers/storefront \
2	-H "X-Auth-Token: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"customerId": 456
6	}'

1	{
2	"data": {
3	"token": [
4	"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6IjEyM0AxMi5jb20iLCJiY19jdXN0b21lcl9pZCI6MzEzLCJzdG9yZV9oYXNoIjoiaW1rOHp6N2ppcCIsImRiIjoiZGVmYXVsdCIsImJjX2NoYW5uZWxfaWQiOjEsImV4cCI6MTY5MDg1NDI5Mn0.97rY-1aGDFKtLbIePR5g202AHZJ0x2kDjmyzGVGK45"
5	]
6	},
7	"meta": {}
8	}