Contact Manager API

The Business Messenger Contact Manager API is a standard REST HTTP API with JSON payload. It can be used to store customer subscription information, create messaging lists, etc. The Business Messenger API authorization is implemented as the industry-standard OAuth 2.0 protocol.

The API is served at https://api{separator}{platform_domain}/news/v1/services/{serviceUuid}/cds/... and, like the Campaign API, uses the OAuth2 client credentials grant: a registered app authorized from a fixed IP address is issued a client_id and client_secret, which are exchanged for a bearer access token used on every request.

All operations are organized under the Contact resource category, covering contacts, lists, subscriptions, subscription options, touchpoints, interests, contact fields, custom fields, segmentation sets, groups, batch contact imports, and aggregate contact KPIs/totals.