Authentication

Verify your identity to grant access to the API

Overview

This API uses OAuth Client Credentials Flow for secure machine-to-machine authentication. This authentication method follows the OAuth 2.0 specification (RFC 6749, section 4.4).

Getting Started

1. Request Credentials

Before you can authenticate contact our team to obtain your unique Client ID and Client Secret

2. Generate Access Token

Once you have your credentials, you can use it to obtain temporary access token. You must monitor access token expiration date and build mechanism to fetch new access token once it expires.

Please don't abuse our auth server by requesting access tokens frequently before its expiration or for each API call.

curl --request POST \
  --url https://auth.integrations.optondemand.com/oauth/token \
  --header 'Content-Type: application/json' \
  --data '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'

3. Use the Token

Include the access token in all API requests:

Authorization: Bearer YOUR_ACCESS_TOKEN