REST API - Generating an Access Token

oAuth Token

To retrieve an oAuth token you will need to pass an Authorization header to the token endpoint in the following format:

Authorisation: Basic [ENCODED_CLIENT+SECRET]

Where [ENCODED_CLIENT+SECRET] is your client id and client secret separated by a colon and Base64 encoded.

Environment Example Request

The environmental token is the same as other requests, except a few details change.

curl -X POST http://oauth.communigator.co.uk/core/connect/token -H "Authorization: Basic [ENCODED_CLIENT+SECRET]" -H "Content-Type: application/x-www-form-urlencoded" -d 
"grant_type=password&username=[ENVIRONMENT_USERNAME]&password=[ENVIRONMENT_PASSWORD]&scope=openid%20GatorMailApi"
Click to copy

[SSO_USERNAME] and [SSO_PASSWORD] needs to be changed to [ENVIRONMENT_USERNAME] and [ENVIRONMENT_PASSWORD].

Access Token Communication with Endpoints

You can then use your access token to call any of the GatorMail, GatorSurvey, or GatorLeads end points.

To do so, call the desired endpoint and pass along an authorisation header like so:

curl -X GET https://api.communigator.co.uk/mail/coinsglobal_testlz/campaign/1/100 -H "Authorization: Bearer [ACCESS_TOKEN]" -H "Content-Type: application/json"
Click to copy

The "Tools -> Integration" screen is unrelated to accessing the API and is only used if you have one of our CRM integrations setup.