Get opt-out categories API

This API is used to get the list of optout-categories.

📘

Know your endpoint

Based on the domain you use to log in to Webex Campaign, the endpoint domain for your API varies. For more information, refer to the Know Your API Endpoints section.

Go to the Postman Collection section to learn how to import a Postman collection. Click the below button, If you already know how to import a postman collection.

Run In Postman

Headers

The following table describes the request headers:

Request HeaderDescription
content-typeapplication/json
authorizationAccess token or API Secret Key in Bearer format

Example: Bearer $(key)

Request Example


https://<yourdomain>.webexcampaign.io/campaignapi/resources/v3/optout-categories

Response Example

[
    {
        "categoryName": "emailCategory",
        "storeName": "surya_emailCategory",
        "unsubListCategoryLabel": "CATEGORY emailCategory UNSUBLINK"
    },
    {
        "categoryName": "emailCategory2",
        "storeName": "surya_emailCategory2",
        "unsubListCategoryLabel": "CATEGORY emailCategory2 UNSUBLINK"
    },
    {
        "categoryName": "EmailOptOutManagement",
        "storeName": "surya_EmailOptOutManagement",
        "unsubListCategoryLabel": "CATEGORY EmailOptOutManagement UNSUBLINK"
    }
  ]

Response Parameters

This API will return the following response parameters:

ParameterDescription
categoryNameReturns the category name
storeNameReturns the store name
unsubListCategoryLabelReturns the unsub list category label.

Failure Response Codes

The API will return code within the response as per the following table in case of failure scenarios.

HTTP Status CodeCode within API ResponseDescription
400400I/O error on post request. Cannot retry due to server authentication, in streaming mode.
401430Authorization failed. This resource is not allowed to access using this TOKEN or KEY
401498Invalid token or Access token expired
404404Not found
405405Method not supported
500500Internal server error
500500Required String parameter 'channel' is not present"
Language