Skip to main content

Get All Campaigns

Retrieve a list of all campaigns configured within a contact center. Campaigns sit within the Contact Center hierarchy: Contact Center → Process → Campaign → Lead.

Endpoint​

GET https://{Cms_Domain_Name}:{port}/configuration/hierarchyconfig/campaign

Authentication​

HeaderValue
Content-Typeapplication/json
Acceptapplication/json
AuthorizationBearer {AuthToken}
info

The AuthToken is obtained from the Token Generation endpoint.

Query Parameters​

ParameterTypeRequiredDescription
contactCenterIdIntegerYesFilter campaigns by contact center ID

Sample Request​

curl -X 'GET' \
'https://{Cms_Domain_Name}:443/configuration/hierarchyconfig/campaign?contactCenterId=1' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {AuthToken}'

Sample Response​

[
{
"campaignContextId": 1,
"campaignContextName": "Mumbai Sales Dept",
"campaignContextType": "Interaction Campaign",
"contactCenterId": 1,
"processId": 1,
"description": "Campaign related to Sales Management",
"dateAdded": "2026-03-24T12:28:52.354Z",
"dateModified": "2026-03-24T12:28:52.354Z",
"ref": 0,
"version": 0
}
]

Response Fields​

FieldTypeDescription
campaignContextIdIntegerUnique campaign identifier
campaignContextNameStringName of the campaign
campaignContextTypeStringCampaign type (e.g., Interaction Campaign)
contactCenterIdIntegerParent contact center ID
processIdIntegerParent process ID
descriptionStringDescription of the campaign
dateAddedStringISO 8601 creation timestamp
dateModifiedStringISO 8601 last modification timestamp
refIntegerReference counter
versionIntegerRecord version number

Error Responses​

Status CodeDescription
400Bad Request — Invalid or missing contactCenterId
401Unauthorized — Missing or invalid token
403Forbidden — Insufficient permissions
404Not Found — Contact center does not exist
500Internal Server Error
{
"statusCode": 404,
"status": "Not Found",
"errorCode": "CONF-1001",
"errorMessage": "Object doesn't exist"
}