---
title: "Dynamic Campaign API: Add Records to a Dynamic Campaign"
slug: "dynamic-campaign-api-add-records-to-a-dynamic-campaign"
updated: 2026-05-17T17:37:55Z
published: 2026-05-21T21:25:23Z
canonical: "help.8x8.com/dynamic-campaign-api-add-records-to-a-dynamic-campaign"
---

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

# Dynamic Campaign API: Add Records to a Dynamic Campaign

## Objective

Add records to a dynamic campaign using the Dynamic Campaign API.

## Applies To

- Contact Center
- Dynamic Campaign API

## Procedure

### Collect the Required Information

1. Contact Center Cluster
  - You can extract the cluster information once you log in to Agent Workspace or Configuration Manager by looking at the URL in your browser.
  - Use the cluster URL without the b, for example, use https://vcc-eu9.8x8.com not https://vcc-eu9b.8x8.com.
2. Tenant Name
3. Data Request Token
  - This can be found in **Configuration Manager for Contact Center** > **Integration** > **API Token**.![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/15215?sv=2026-02-06&spr=https&st=2026-11-03T22%3A20%3A13Z&se=2026-11-03T23%3A20%3A13Z&sr=c&sp=r&sig=Af7JQNyQOHTQFBo6B%2FVPML9hLgiMgzY7MYR6Ifrnb%2Fw%3D)
4. Campaign ID of the campaign to add records to.
  - This can be found in **Configuration Manager for Contact Center** > **Campaigns** > **Campaign Properties**.![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/15217?sv=2026-02-06&spr=https&st=2026-11-03T22%3A20%3A13Z&se=2026-11-03T23%3A20%3A13Z&sr=c&sp=r&sig=Af7JQNyQOHTQFBo6B%2FVPML9hLgiMgzY7MYR6Ifrnb%2Fw%3D)
5. CRM Customer ID of records to be added to the campaign.
  - This can be found in **Agent Workspace** > **Customers**.

### API Request

Replace sample text with your data.

```plaintext
POST https://vcc-cluster.8x8.com/api/tstats/campaigns/campaign-id/customers
```

#### Authorization

Basic Auth

Username: *Tenant Name*

Password: *Data Request Token*

#### Body to add a single record

```plaintext
[
    {
        "customer-id": "10000160"
    }
]
```

#### Body to add a multiple records

```plaintext
[
    {
        "customer-id": "10000160"
    },
    {
        "customer-id": "10000161"
    }
]
```

#### Body to add a single record with a schedule

```plaintext
[
    {
        "customer-id": "10000160",
        "schedule-date-time": "2016-08-29T09:00:00.000Z"
    }
]
```

#### Body to add a multiple records with a schedule

```plaintext
[
    {
        "customer-id": "10000160",
        "schedule-date-time": "2016-08-29T09:00:00.000Z"
    },
    {
        "customer-id": "10000161",
        "schedule-date-time": "2016-08-29T09:00:00.000Z"
    }
]
```

### Example

This example adds the customer record id 10000160 to thr dynamic campaign id 521 for a tenant on the eu9 cluster.

The Authorization headers base64 encoded tenantName:DataRequestToken has been redacted.

#### Request

```plaintext
curl --location --request POST 'https://vcc-eu9.8x8.com/api/tstats/campaigns/521/customers' \
--header 'Authorization: Basic *********************************' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "customer-id": "10000160"
    }
]'
```

#### Response

Status: 207 Multi-Status (WebDAV) (RFC 4918)

```plaintext
[
   {
        "customer-id": "10000160",
        "http-status": "200",
        "message": "Campaign customer added."
    }
]
```

## Additional Information

### Identifying the Contact Center CRM customer-id

The CRM "customer-id" used in the dynamic campaign API can be located at the top of the customer's record in Agent Workspace and is also known as the "account." In the CRM API (wapi) this id the <accountnum> field.

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/15216?sv=2026-02-06&spr=https&st=2026-11-03T22%3A20%3A13Z&se=2026-11-03T23%3A20%3A13Z&sr=c&sp=r&sig=Af7JQNyQOHTQFBo6B%2FVPML9hLgiMgzY7MYR6Ifrnb%2Fw%3D)