Skip to main content
POST
/
api
/
v2
/
authentication
/
token
/
api-key
API key token (V2)
curl --request POST \
  --url https://api.telemax.com.au/api/v2/authentication/token/api-key \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data apiKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 86399
}

​
Overview

Exchanges a Telemax company API key for a signed JWT. Use this for server-to-server integrations where no user identity is required.
This endpoint replaces V1 API key token.

​
Endpoint

POST /api/v2/authentication/token/api-key

​
Authentication

Not required (public endpoint).

​
Request headers

HeaderRequiredValue
Content-TypeYesapplication/x-www-form-urlencoded

​
Request body (form)

​
apiKey
string
required
Company API key (GUID format, issued from the Telemax dashboard).

​
Response

200 OK — JwtTokenResponse
FieldTypeDescription
access_tokenstringBearer token for subsequent API calls
token_typestringAlways bearer
expires_innumberToken lifetime in seconds

​
Example response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 86399.0
}

​
Error responses

StatusMeaning
401Invalid or unrecognised API key
curl -X POST "https://api.telemax.com.au/api/v2/authentication/token/api-key" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "apiKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Body

application/x-www-form-urlencoded
​
apiKey
string
required
Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Response

Successful response