---
title: "8x8 Contact Center Streaming API"
slug: "8x8-contact-center-streaming-api"
updated: 2026-05-22T19:26:06Z
published: 2026-05-22T19:26:06Z
canonical: "help.8x8.com/8x8-contact-center-streaming-api"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://help.8x8.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 8x8 Contact Center Streaming API
## Overview
The 8x8 Streaming API (SAPI) features a set of functionalities to allow 8x8 Contact Center tenants to receive information related to Agent status updates, Agent provisioning updates, and Interaction updates. These updates are referred to as events. Any Async HTTP client can be used to receive SAPI events.
The primary purpose of this SAPI is to provide data on real time events. Data is published to all clients through a server push mechanism. To learn more about this mechanism, see this article on Server push.
## Subscribing to Events
The best way to understand and test the features of the 8x8 SAPI is to use a web client. The web client is easy to use. In a browser on the same network as your tenant, enter the link provided below.
```plaintext
https://vcc-{cluster}.8x8.com/api/streaming/v1/clientconnect/subscribe/TenantUpdates-{tenantName}-{subscriptionId}?desiredOutputType=NEWLINE_JSON&tenantId={tenantName}&subsId={subscriptionId}&X-Atmosphere-Transport=streaming
```
> [!NOTE]
> Note:
>
> Remember to replace the cluster with your platform URL. This link will open a page with some input fields.
### Purpose of the Fields
1. **Subscription ID** is the unique ID for identifying the SAPI connection from the tenant. Each tenant should manage its own subscription ID. Since the SAPI stores messages for a certain period of time even if the client is disconnected, using same subscription ID is important in order to receive stored messages.
2. **Tenant ID** is the tenant ID provided by 8x8.
3. **Desired Output** type. This can be either XML or JSON.
4. **Subscribe** will initiate a subscription to events over the next 60 minutes.
5. **Unsubscribe** will disconnect the client from the SAPI server and start storing messages for reconnection.
## Agent Status Updates
This configuration returns information from agents about real time agent status changes.
```plaintext
marcus
2
1381563857
```
## Agent Provisioning Updates
This configuration returns information from agents about real time provisioning changes.
```plaintext
122
1
phoneUri
+17034443909
17034443910
...
```
## Interaction Updates
This configuration returns information from agents about real time interactions.
```plaintext
in
1381573170
4070001
int-dev6ctl-09c05006-0f19-44cf-9410-c55fe515d76c-phone-00iQ1DcskDJEumYROhxeq3gvYeY
phone
0
dev6ctl~~queue~~phone~~102
1381573170
1
tenantSkillName
Sales
...
```
## Authentication
In order to make a SAPI request, you must first obtain the authentication token that has been issued for your tenant. This token combines username and password into a single string. You will use this token in all requests to the SAPI. You may generate a new token at any time.
### To generate the Authentication Token
1. Log into the **SAPI Configuration Manager**.
2. Select **Integration**.
3. Click **API Token**.
4. Click **New Token** next to **Data Request Token**. This generates a new private token for your tenant. The image below shows the authentication window.
## Important Notes
Some things to keep in mind when using the 8x8 SAPI:
1. Only three clients per tenant are allowed to listen at a given time.
2. The subscription ID should be unique for every connection.
3. A subscription session is valid for only sixty minutes. That is, if the connection times out, you will need to reconnect. However, no data is lost if reconnection occurs within two hours, since messages are stored and sent when the connection is restored.
4. A two-hour history of events is provided, if the client connects with the previously used subscription ID.
5. Desired output can be either XML or JSON.
6. If a subscription has been disconnected for more than two hours, it will be automatically unsubscribed. No more messages will be stored after unsubscribing.
To download the 8x8 SAPI client,  [click here](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/vcc-sapiclient.zip?sv=2026-02-06&spr=https&st=2026-11-03T21%3A29%3A43Z&se=2026-11-03T22%3A29%3A43Z&sr=c&sp=r&sig=UShlFfO5XMrnysSxAlK5LfF8O6nk%2BKCpEcgeBb8QXtw%3D).