Objective
This guide outlines the steps to generate an OAuth access token using 8x8's API and retrieve API data.
Applies To
- API
Procedure:
Step 1: Create Your 8x8 App in Admin Console
- Log in to Admin Console.
- Click API Keys.
- Click Create App.
- Enter App Name.
- Select desired atttributes for API Products.
- Click Save.
Step 2: To Generate Access Token for OAuth
- Launch Postman
- Click (+) sign to "Create a New Request"
- Method: POST
- Endpoint URL: https://api.8x8.com/oauth/v2/token
- Click "Authorization"
- Auth Type: Basic Auth
- Username: Your 8x8 app key
- Password: Your 8x8 app secret
| Note: The app key and app secret were created in Admin Console in Step 1. |
- Click "Body"
- Select "x-www-form-urlencoded"
- Add the following key-value pair:
- Key: grant_type
- Value: client_credentials
- Click "Send" to generate the "access token".
|
Note: Copy and save access token to text editor |
Step 3: Retrieve desired API (e.g.: Realtime Queue Metrics)
- Use existing or click (+) sign to "Create a New Request"
- Method: GET
- Endpoint URL: https://api.8x8.com/analytics/cc/v5/realtime-metrics/queues
| Note: This API is for queue_id, name, metrics. |
- Click Authorization.
- From "Auth Type", click drop-down and select Bearer Token.
- Token: Add the "access token" from Step 2.
- Value: Paste the generated access token here.
- Click Send to generate the request API data
- From "Auth Type", click drop-down and select Bearer Token.
Additional Information
You may include additional headers or query parameters based on your specific use case. For more details and available options for other APIs, refer to the official 8x8 API documentation:
➡️ 8x8 Developer Hub
➡️ 8x8 Developer Hub
Ensure your App Key and Secret are kept secure and not shared publicly.
OAuth tokens may expire; always retrieve a fresh token if your current one fails authentication.