This page will help you get started with Messaging API.

Webex Connect multichannel Messaging API is a RESTful API that allows you to send proactive outbound messages and/or respond to incoming customer messages across various channels supported by the platform.

Channels covered by the Messaging API are:

  • SMS
  • Voice
  • RCS Business Messaging
  • Email
  • Push Notifications (Android, iOS, Web)
  • In-App Messaging (Real-Time App Messaging)
  • Apple Messages for Business
  • Facebook Messenger
  • WhatsApp

Batching Requests

You can send a message to a single recipient or to multiple recipients by making a single API call. If you want to send messages to multiple recipients at once you would need to provide the list of recipients in the destination array while making the API call.

You can send batch messages on multiple channels with a single API request. For example, a bank can send a personalized greeting message to its customers using the delivery channel as SMS. Using batch message API requests, you can send messages to up to 1000 destinations (subject to your TPS limits). E.g., if your messaging API TPS configuration is 10 you can send messages to up to 10 destinations at once.


Following are the prerequisites to send and receive messages using Messaging API:

  • Login credentials to access Webex Connect
  • Authentication Credentials

Either a Service Key or JSON Web Tokens (JWT) must be passed with every API request. For more details visit the API Authentication section.

API Parameters

Webex Connect Messaging API is a RESTful API served over the encrypted HTTPS protocol. For data privacy and security reasons, the standard HTTP protocol is not supported.

deliverychannelStringYesSpecifies the channel to send a message. (sms/voice/push/rt/messenger).
destinationJSONArrayYesThe destination parameter is a sub-parameter array of strings. This allows multiple destinations.
channelsJSONArrayYesThe channel parameter encompasses sub-parameters.
messageJSONObjectNoThis parameter is used when the message consisting of a predefined template.
routeStringNoRouting policy to use. The options are:
expiryStringNoExpiry time in UTC format, after which messages will not be pushed. For example, 2015-04-12T13:00:19.456Z or 2015-04-12T18:30:19.456+5:30.
correlationidStringNoA unique transaction ID up to 50 bytes used by Service Providers to match requests with responses.
notifyurlStringNoA URL that receives notifications. This overrides the service's Notify URL.
callbackDataStringNoData to be passed alongside notifications to the notifyurl. This can serve as identifying notifications.
priorityStringNoThis parameter is used to specify the message priority.

Response/Return Codes

This API returns one of the following response codes:

Response CodeMessageDescription
1001QueuedReturned when the request is accepted by Webex Connect.
7000Invalid JSONReturned when an invalid JSON request is sent.
7001Authentication failedReturned when an invalid service key or profile key is provided in the request.
7002Service key missingReturned when the parameter key is missing in the message request.
7003Mandatory parameters missingReturned when the mandatory parameters configured in the custom event are missing.
7004Invalid parametersReturned when the parameters are invalid.
7006Internal error occurredReturned when an internal error occurs.
7007Service inactiveReturned when the service is in an inactive state.
7009Max number of destinationsReturned when an API request exceeds the limit (1000) to send messages using messaging API.