Appearance
Create access token
POST
/access-tokens/
Create an API access token for an integration with specific scopes. The returned token should be used as a Bearer token for authenticating API requests.
You can limit the token's permissions by specifying allowed HTTP methods and paths in the scopes array.
Request Body
application/json
JSON
{
"name": "Data imports",
"owner_id": "integrations/4ii6go3zs2tg",
"scopes": [
{
"method": "POST",
"path": "/api/customers/upload/"
}
],
"transfer_privileges": true
}
Responses
Access token created successfully
application/json
JSON
{
"access_token": {
"id": "gw44n2x2nlqu",
"owner_id": "integrations/4ii6go3zs2tg",
"created_at": "2026-01-09T20:29:57Z",
"hint": "API***YPP",
"name": "data imports",
"created_by": "users/1",
"transferred_roles": [
[
"admin",
"staff",
"superuser"
]
],
"scopes": [
{
"method": "string",
"path": "string"
}
],
"token": "APICODEXU5SLHM3ZFHYCXW4FSLY2D7Y2RHO3RYPP"
}
}