How to Set up Sending Webhooks to Your System

A webhook is a mechanism for notifying a system about events. Using webhooks in Automation 360 is a way to notify your system about events that happen.

What Can a Webhook Do

Sending webhooks allows SendPulse service you to receive updates when customers' status changes or when the automated series reaches a specific goal.

For example, leads leave requests on your site; their contact details are sent to your CRM system and sync with SendPulse. An Automation 360 flow helps with warming up your leads. You want to call everyone who opens the third email in the flow. To do this, you need to change the status of the leads in your CRM. You can do this with the help of a webhook by sending data about an event to your system.

How to Send a Webhook in an Automation Flow

To send event notifications to another system, link the "Action" - "Send webhook" block to the block from which you want to track an event. You can track receiving or opening an email, filtered by a specified condition, achieving a goal, or any other action performed by a subscriber within an automation flow.

Specify a webhook name and a URL to which the webhook will be sent. Only numbers and Latin characters are allowed in a webhook name.

Configure sending the key in response to the first webhook to remove the limit for sending webhooks. Otherwise, the service will allow you to send one webhook per hour.

Webhook Structure

[
   {
      "automation_id":"123456789",
      "title":"New Automation",
      "execution_date":"2022-01-04 09:02:39",
      "email":"example@example.com",
      "phone":"+380631234567",
      "variables":[
         {
            "name1":"value1"
         },
         {
            "name2":"value2"
         }
      ]
   }
]

A webhook transmits such data:

• a flow ID;
• a webhook name;
• a webhook trigger date;
• an email address and a phone number of a subscriber for whom the webhook is sent;
• variable data.

If an automation starts with a mailing list, variables from the mailing list are sent in the webhook. If automation begins with an event, variables from the event are sent in the webhook.

How to Track Unsubscribes and Spam Complaints

You can configure tracking unsubscribes and spam complaints in your account settings.

An example of a spam complaint webhook:

[
   {
      "timestamp":1496827422,
      "event":"spam",
      "task_id":3668141,
      "email":"john.doe@sendpulse.com",
      "source":"automation360",
      "automation_id":"123456789"
   }
]

An example of an unsubscribe webhook:

[
   {
      "task_id":"3668141",
      "timestamp":"1496827872",
      "from_all":1,
      "email":"john.doe@sendpulse.com",
      "reason":null,
      "book_id":490686,
      "event":"unsubscribe",
      "categories":"",
      "source":"automation360",
      "automation_id":"123456789"
   }
]

Last Updated: 09.01.2023