POST/v1/tenants/{tenantId}/oauth2/v2.0/token

Create an access token using the tenant-scoped compatibility endpoint

Compatibility endpoint for existing SnowBee integrations. New integrations should use POST /oauth2/token.

Supports application/json and application/x-www-form-urlencoded requests with client_secret_post authentication.

application/x-www-form-urlencodedobjectnon-null

client_idstringnon-nullrequired: Client ID from your API credentials
Example"your-client-id"
client_secretstringnon-nullrequired: Client secret from your API credentials
Example"your-client-secret"
grant_typestringnon-nullrequired: Allowed values"client_credentials"
resourcestringnullableoptional: One assigned eCom store or loyalty program ID for legacy ecom or loyalty_programs. Omit for modern permissions.
scopestringnon-nullrequired: Space-separated granted permissions, including Core scopes, ecom:read, ecom:write, loyalty_programs:read and demand_planning. Legacy ecom and loyalty_programs must be requested alone with resource.
Example"ecom:read ecom:write loyalty_programs:read"

application/jsonobjectnon-null

client_idstringnon-nullrequired: Client ID from your API credentials
Example"your-client-id"
client_secretstringnon-nullrequired: Client secret from your API credentials
Example"your-client-secret"
grant_typestringnon-nullrequired: Allowed values"client_credentials"
resourcestringnullableoptional: One assigned eCom store or loyalty program ID for legacy ecom or loyalty_programs. Omit for modern permissions.
scopestringnon-nullrequired: Space-separated granted permissions, including Core scopes, ecom:read, ecom:write, loyalty_programs:read and demand_planning. Legacy ecom and loyalty_programs must be requested alone with resource.
Example"ecom:read ecom:write loyalty_programs:read"

200Response

application/jsonobjectnon-null

access_tokenstringnon-nullrequired: JWT access token to use for API requests
Example"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
expires_inintegernon-nullrequired: Token expiration time in seconds
Format: int32
Example3600
scopestringnon-nullrequired: Scope granted to the access token
Example"ecom"
token_typestringnon-nullrequired: Allowed values"deleted"

400Invalid OAuth token request

Invalid OAuth token request

application/jsonobjectnon-null

errorstringnon-nullrequired: OAuth 2.0 error code
Example"invalid_request"
error_descriptionstringnon-nullrequired: Human-readable error description
Example"The tenant_id parameter is required"
resolutionstringnon-nullrequired: Suggested next action
Example"Add tenant_id to the form-encoded request and retry"

401Client authentication failed

Client authentication failed

application/jsonobjectnon-null

errorstringnon-nullrequired: OAuth 2.0 error code
Example"invalid_request"
error_descriptionstringnon-nullrequired: Human-readable error description
Example"The tenant_id parameter is required"
resolutionstringnon-nullrequired: Suggested next action
Example"Add tenant_id to the form-encoded request and retry"