This article explains what webhooks are and how to set them up for your Hunter Sequences, so you can send real-time notifications to other applications whenever a sequence event occurs.
What are webhooks
Webhooks are notifications about various events that occur for your sent email sequences. These notifications can be used to integrate Hunter Sequences with other applications.
When you create a Webhook, it sends a POST request to the URL of your choice whenever the specified event occurs. There are 4 events you can use:
Email sent
Email opened
Link clicked
Email replied
Webhooks can be configured to be added to all your email sequences by default, or you can create a webhook linked to a specific email sequence only.
đĄ The URL must be a public, internet-reachable address. Hunter can't deliver webhooks to private, internal, or loopback addresses, like localhost or 127.0.0.1.
Configure a webhook for all your email sequences
To configure default webhooks for all your email sequences:
Go to the Sequences Settings page.
Click "Webhooks".
Enter the URL you want Hunter to send the POST request to.
Choose the event that will trigger the webhook. You can create 1 webhook per type of event.
Hunter automatically adds these default webhooks to all your new email sequences.
Configure a webhook for a single email sequence
If you'd like to set up a webhook for a specific email sequence, you can configure it directly in the "Integration" tab of that sequence.
đ You'll only see this option after you launch the sequence.
Check your webhook setup
To see an example of what data will be part of the webhook, you can click on the question mark icon as shown in the screenshot below:
This is what a Webhook example looks like:
Checking webhook delivery status
If Hunter can't successfully deliver a webhook â for example, because the receiving app didn't accept it, or couldn't be reached â you'll see a "Failing" badge next to that webhook on the Webhooks page.
Hover over the badge to see why it failed and when the last attempt happened.
If you see this badge, double-check the URL you entered is correct, and that the tool or app you're sending it to is online and able to receive requests. If you're not sure, reach out to whoever manages that app for help.
If the URL points to a private, internal, or local address, Hunter won't be able to deliver to it â webhooks only work with publicly reachable endpoints.
To sum things up:
Webhooks send a POST request to your chosen URL when an email is sent, opened, clicked, or replied to.
You can set them up for all your sequences by default, or for a single sequence in its "Integration" tab.
The receiving URL must be public â Hunter can't deliver to private, internal, or loopback addresses.