Flex Insights API Authentication
Prerequisites
Before you start exporting data you will need to have:
- a provisioned Flex Insights (also known as WFO) Workspace
- the credentials of a user with access to the Flex Insights Workspace
API Authentication
The procedure requires 2 API calls.
The first authenticates and returns an SST (Super Secured Token) using your login and password. Once the SST is available, a TT (Temporary Token) must be requested. The TT has to be included in any subsequent API calls.
SuperSecure Tokens (SST) have a default lifetime of two weeks. Temporary Token (TT) is valid for 10 minutes.
In order to obtain the password for direct login, please contact the Flex Insights Support Team.
If you received a status code of 429, this means that you made too many invalid login requests. Check your credentials, and look for the Retry-After HTTP header in the response: this specifies the period (in seconds) after which you can attempt to log in again.
Retrieving the Temporary Token
You must have a valid Temporary Token (TT) for all subsequent calls to the API. To get a valid TT, use the following API:
If you are using a REST client which supports cookies, on the initial login request you can set "verify_level": 0 and use the returned cookie called GDCAuthTT (which contains the Temporary Token) directly in subsequent API calls. This way, you don't need to adjust the Header manually.
Once the Temporary Token expires, you have to call the Token API to refresh it.
API Usage
For any subsequent API calls, ensure that the TT is always passed in the headers as a cookie with the name GDCAuthTT
After successful authentication you can Export Data from Flex Insights via API.
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
