How To Generate OAuth Token and Make Desired API Call via Postman

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

1. Log in to Admin Console.

2. Click API Keys.

3. Click Create App.

4. Enter App Name.

5. Select desired atttributes for API Products.

6. Click Save.

Step 2: To Generate Access Token for OAuth

1. Launch Postman    

   • Click (+) sign to "Create a New Request"

   • Method: POST

   • Endpoint URL: https://api.8x8.com/oauth/v2/token

2. 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.

3. Click "Body"    

   • Select "x-www-form-urlencoded"

   • Add the following key-value pair:      

     • Key: grant_type

     • Value: client_credentials          

4. 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)

1. 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.

2. 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

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  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.