---
title: "Token"
method: POST
path: "/tokens"
tags: ["Authentication"]
---

# Token

`POST /tokens`

Exchange client application credentials for a bearer token. Please ensure to call the auth issuing server as described at https://developer.assemblypayments.com/reference#authentication

## Request body

- TokensRequestBody
  - `grant_type` string, required — This is a constant value of `client_credentials`
  - `client_id` string, required — This value is supplied to you by Assembly Payments.
  - `client_secret` string, required — This value is supplied to you by Assembly Payments.
  - `scope` string, required — This value is supplied to you by Assembly Payments.

## Response `200`

Response body contains an access token with lifetime in seconds and usage information.

- TokensResponse
  - `access_token` string — JWT issued by AWS Cognito.
  - `expires_in` number — Lifetime of access token in seconds.
  - `token_type` string — Authorization header value prefix. This is a constant.

## Other responses

- `400` — Request not parseable, grant type invalid or properties missing
- `401` — We can't resolve the supplied credentials
- `422` — One or more property values are unprocessable
- `500` — We have a problem, which we have logged. Please try again later and if it still doesn't work, contact us.

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/revisions/60b528b2e015/schema)