Skip to main content
POST
Exchange Client ID / Client Secret for Access Token
Exchanges Client ID and Client Secret for a short-lived Access Token. This is the first call every ACB API consumer makes using Syteca 7.28+ — the returned Access Token authenticates subsequent calls to other endpoints. When the Access Token expires, call this endpoint again with the same Client ID and Client Secret.

Where to get the Client ID / Client Secret

The Client ID / Client Secret comes from the Application Account Settings section of a Management Tool user — see Set up user account.

Rate limit

API requests authenticated with Client ID / Client Secret are rate limited per Client ID, not per secret or per token. Every request made with the same Client ID counts toward one quota, no matter how many Client Secrets or active Access Tokens the account holds.

Errors

See Status codes. Common errors:
  • 400 Bad Request — Missing grant_type, client_id/client_secret or grant_type is not client_credentials.
  • 401 Unauthorized — invalid, rotated Client Secret or Client Secret doesn’t match the Client ID. Verify Client ID and Client Secret, and check whether the user’s external-app toggle was disabled.
  • 403 Forbidden — the request originates from an IP not in the user’s IP Address restriction.

Set up user account

Where to get the Client ID / Client Secret.

API reference

Status codes, rate limiting, conventions.

Migrate to Client ID / Client Secret Authentication

Migrate from Refresh Token to Client Credentials flow.

Body

application/x-www-form-urlencoded
grant_type
enum<string>
required

OAuth 2.0 grant type.

Available options:
client_credentials
client_id
string
required

Client ID from the user's Application Account Settings in the Management Tool.

client_secret
string
required

Client Secret from the user's Application Account Settings in the Management Tool, which is shown once after adding it.

Response

Access Token issued successfully

access_token
string

Access Token to use on subsequent API calls (Authorization header for new endpoints).

token_type
string

Access Token Type to use on subsequent API calls (Authorization header for new endpoints).

expires_in
integer<int32>

Seconds until the Access Token expires. Default 900. Minimum 60.