API Authentication

Authenticating to the API uses a client credential model for back-end access only. Ad Astra will provide an authentication URL, client id, and client secret per customer that partners can use to request an access token for use by their services for that customer. 

Endpoint

https://<customer specific URI>/oauth2/token

REST Verb

POST

POST Body

Submitted as a x-www-form-urlencoded formatted POST with the following fields and values:

• client_id: Supplied by Ad Astra
• grant_type: “client_credentials”
• scope: “partner-api/activities”

Endpoint Authentication

Basic authentication scheme:

• username: Client ID supplied by Ad Astra
• password: Client Secret supplied by Ad Astra

Results Example

{

    "access_token": “<base64 encoded token>”

    "expires_in": 3600,

    "token_type": "Bearer"

}