SMS Opt Out Received

Be notified when a number has been added to your Opt Out List.

Events

Event NameDescription
Opted outTriggered when an opt out keyword or an opt out webform submission has been revieved and the number has been added to the Opt Out List. Note that this is not triggered when numbers have been imported into an Opt Out List.

Payload Samples


{
  "specversion": "1.0",
  "type": "com.interact.messages.sms.opt.out",
  "source": "https://api.webexinteract.com/v1/sms",
  "id": "evt_36Ko1hKxBAQ7X9VrGoBxPoK7Om0",
  "time": "2025-12-03T12:20:10Z",
  "datacontenttype": "application/json",
  "data": {
    "status": "opt_out",
    "channel": "sms",
    "message": "STOP",
    "type": "keyword",
    "phone_number": "+447807127129",
    "inbound_number": "+447807127121",
    "inbound_number_id": "num_36IR2Jpl1u1wOuRBgmMmoMhawjE",
    "account_level_opt_out": false,
    "opt_out_time": "2025-12-03T12:20:10Z"
  }
}

Field Definitions

ParameterDescription
typeSpecifies the event type.
sourceIndicates the event's origin, such as the API URL.
idUnique webhook event identifier.
timeTimestamp (ISO 8601 format) of the event.
datacontenttypeSpecifies the data format, typically "application/json".
→ statusSpecifies the event: "opt_out".
→ channelSpecifies channel that the message was received on.
→messageMessage body received.
→phone_numberThe senders phone number.
→inbound_numberYour Webex Interact phone number that the message was received on.
→inbound_number_idThe UID of the Webex Interact phone number that the message was received on.
→account_level_opt_outFalse if the number has requested to opt out on a number asset where 'Enforce account level SMS opt-outs' is unchecked (see Channel Setup>numbers>Manage number). Otherwise True.
→ opt_out_timeTimestamp (ISO 8601 format) relating to when the number was added to your Opt Outs List.
correlation_idA unique identifier assigned to each request for tracking and reference. It can be included in API requests as per your preference. If not, Interact will assign automatically.