Congratulations on building your Gladly integration. Now you can test the myriad possibilities of the Gladly API in a safe, secure space. This guide will help you wrap your head around the testing and iteration process.
Sandbox Environment #
If you do not have a sandbox environment and are interested in purchasing one, please contact Gladly CSM or Support team. Sandbox environments are a great way to test your code without impacting your production environment.
Your sandbox environment will be accessible at
where organization is your company name.
Set Up API Users #
Gladly Administrators can set API permissions on an Agent-by-Agent basis. We’ll discuss how this maps to API access in the Authentication section below. Of course, the API User will also have access to Gladly overall.
To allow a user to create API tokens and access the API:
- Log in to your Gladly instance.
- Open the menu on the top left-hand corner of the page.
- Navigate to Settings > Users.
- Search and click the user profile that should have access.
- You’ll see a permission called API User. Select it, while making sure to keep the user’s Agent role intact.
- Hit Save to give access.
We recommend creating a dedicated user to make API calls whose account won’t be used for Agent and organization management. This will help with future audits of API and agent activity.
API Tokens #
You must create an API token to access Gladly API resources (see above).
If your profile already has access to the API User permission, you’ll see a menu item titled More Settings.
- Click More Settings.
- Click API Tokens then Add Token button on the upper right-hand corner of the page.
- A token will be generated and named New Token by default.
- If you have existing tokens, it might be named New Token 2, New Token 3, etc.
- Click the name to rename.
You will only see a new token once before you navigate Away from the page. This token will be associated with your Agent profile.
Replace and Rotate #
If you lose this token or it is time to rotate your application keys:
- Generate a new token.
- Store the new token in a secure location.
- Delete the old token.
- Update your applications and scripts with the new token.
Gladly API uses token-based Basic Authentication. API tokens are associated with designated Gladly users. To create and use an API token, your user must have the API User permission. An API token can be used to perform any API request without restriction.
The credentials must be passed via an Authorization HTTP header. All requests must be made over HTTPS.