REST API - Generating an Access 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"
[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"
The "Tools -> Integration" screen is unrelated to accessing the API and is only used if you have one of our CRM integrations setup.