Webhooks are real-time notifications sent to your specified URL whenever certain events happen in your Instantly campaigns. This feature is available on the Hyper Growth plan or above.
As soon as a new event occurs (such as emails being opened or replies arriving),
Instantly immediately sends event data to your webhook URL.
Instantly webhook notifications are sent via a POST request, while the request body (with response data) is in JSON format.
Instantly users who understand how to handle webhooks will be able to take advantage of this advanced feature. Our team cannot troubleshoot your code or provide step-by-step development instructions.
How to Set Up Webhooks
For the purpose of this demonstration, and to check your own test URLS, you can use this link to collect test submissions.
Here are the steps to set up your webhooks:
Go to the Integrations tab. You'll find webhooks in the list.
Click Add Webhook to make a new connection.
Enter a destination URL. This is where we will make HTTP POST requests.
Add headers: Attach custom HTTP headers for authentication or extra context on your Webhook. Existing Webhooks can also be edited.
Select the event type from within the campaign to send notifications for.
Select the campaign you want to send event notifications from for this webhook.
Click Add Webhook
Available Webhook Events
Here are the available events for webhook:
Email sent
Email bounced
Email opened
Email link clicked
Reply received
Lead unsubscribed
Campaign completed
Email account error
Lead is marked as interested
Lead is marked as not interested
Lead is marked as neutral
Lead status changed to Meeting booked
Lead status changed to Meeting complete/Not closed
Lead status changed to Close
Lead status changed to Out of office
Lead status changed to Wrong person
Other custom labels you created
Understanding Webhook Payloads
Here is a sample payload that is sent via POST.
{
"timestamp": new Date().toISOString(), // time of event
"event_type": event_type // example: [email_opened, email_sent, etc.]
"campaign_name": "your_campaign_name",
"workspace": "your_workspace_id",
"campaign_id": "your_campaign_id
}Here is additional information sent (based on the type of webhook and availability of data).
lead_email
firstName
lastName
companyName
website
phone
step [sequence step number]
email_account [your email account that contacted the lead]