Skip to main content
POST
Obtain an access token

Authorizations

zivio-tenant-id
string
header
required

Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.

Body

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

OAuth 2.0 grant type

Available options:
client_credentials
client_id
string
required

Your application client ID

client_secret
string
required

Your application client secret

scope
string

Space-separated list of scopes (e.g., "projects:read invoices:read")

Example:

"projects:read milestones:read invoices:read"

Response

Access token issued successfully

access_token
string

The access token

token_type
string
Example:

"Bearer"

expires_in
integer

Token lifetime in seconds

scope
string

Granted scopes