Unsubscribes

An unsubscribe event occurs when a recipient either clicks the unsubscribe link provided in your content or the unsubscribe button provided by some Email Service Providers.

List of Body Attributes

This table shows the list of parameters present in the payload and their explanations.

ParametersData TypeDescription
webhook_nameStringName of the webhook you configured.
webhook_idStringID of the configured webhook.
actionStringName of the event.
actionTypeStringName of the event.
action_byStringIndicates by whom the action was made.
action_timeLongTime at which the unsubscribe event happened.
contact_idLongID of the contact who unsubscribed.
contact_emailStringEmail address of the contact unsubscribed.
dataJSON ArrayAn array of data about the events.
rcpt_additional_dataJSON ObjectAdditional data of the recipient that was provided by you in Transmission API or Recipient List API.
transmission_nameStringThe name you provided for the transmission in Transmission API.
injected_timeLongThe time the transmission was created.
transmission_idLongThe ID of the transmission.
zuidLongThe ID of the user that sent the transmission API request.

Sample payload for an unsubscribe event

Copied{
  "webhook_name": "Unsubscribe webhook",
  "webhook_id": "1314909000000063006",
  "action": "unsubscribed",
  "actionType": "doNotMail",
  "action_by": "contact",
  "data": [
    {
      "action_time": 1725461219974,
      "contact_id": 1314909000000144100,
      "contact_email": "john.doe@zylker.com",
      "rcpt_additional_data": {
        "country": "JP",
        "Phone": "1239333320"
      },
      "transmission_name": "My first Email API Campaign",
      "injected_time": 1725543431000,
      "transmission_id": 13149090000001440022131,
      "zuid": 8575431221455
    }
  ]
}