Skip to main content

Server to Server (OAuth) Authentication

Purpose​

The Incentify web service supports the server-to-server OAuth authentication method in order for its customers' technical team members to build systems integrations.

Request - OAuth Token​

The OAuth Token Endpoint supports a server to server method to retrieve an “access token”. This requires a client_id and a client_secret, as shown below:

Endpoint

/oauth/token

Request Body

{
    "grant_type": "client_credentials”,
    "client_id": "your-client-id-here”,
    "client_secret": "your-client-secret-here”,
    "scope": "*”
}

Response - OAuth Token​

The OAuth Token Endpoint responds in JSON format with a limited-lifespan “access token”, which can now be used to make API Calls (detailed in the next section). sadf

Response Body

{
    "token_type": "Bearer”,
    "expires_in": "31622400”,
    "access_token": "your-access-token”
}

Supply the Access Token in your API requests to Incentify Resources.

NOTE: This access token will work for X minutes (based on your configuration of X).