Service Login

POST

/connect/token

Authenticates a service account using the OAuth2 client credentials flow. Returns an access token used to authorize all other API requests. client_id and client_secret are obtained from Hatif's website as follows. Settings → API Connect → API Credentials.

Note: This endpoint should only be called from a trusted server-side environment (backend, script, desktop app). Calling it from a browser-side JavaScript will result in a 500 error since the client_secret would be exposed.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/x-www-form-urlencoded

Responses

🟢200OK

application/json

Returns the access token to use for authenticating subsequent API requests.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/connect/token' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'client_id=your-client-id' \
--data-urlencode 'client_secret=your-client-secret' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scope=VoxaAPI'

Response Example

{
    "access_token": "eyJh...",
    "token_type": "Bearer",
    "expires_in": 1295999
}

Modified at 2026-06-29 13:35:06

Rate Limiting

Get Channels