All Collections
Integrations
How to use Webhooks? ๐Ÿ•ธ๐Ÿช
How to use Webhooks? ๐Ÿ•ธ๐Ÿช

Use webhooks to get important campaign events sent straight to a compatible web app or URL as soon as itโ€™s detected.

Ollie avatar
Written by Ollie
Updated over a week ago

What are webhooks?

Webhooks are notifications sent over the Web and triggered whenever a certain event occurs.

In this case, the event is a new campaign event in Instantly. As soon as an event occurs (such as emails being opened or replies arriving), a notification with the response data is immediately sent to the webhook URL which is set in the configuration panel.

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 https://requestbin.com collect test submissions

  1. Go to your Instantly settings, then go to Integrations. You'll find webhooks in the list

  2. Click on 'Add Webhook' to make a new connection.

  3. Now, enter a destination URL. This is where we will make HTTP POST requests

  4. Select the campaign you want to send event notifications from, for this webhook.

  5. Select the event type from within the campaign to send notifications for.

  6. Click on 'Add webhook' after all three fields are done, and you should be able to see it added in the list, where you can add new webhooks or delete existing ones.

Hereโ€™s a sample payload (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
}

Additional information sent (based on type of webhook and availability of data):

  1. lead_email

  2. firstName

  3. lastName

  4. companyName

  5. website

  6. phone

  7. step [sequence step number]

  8. email_account [your email account that contacted the lead]


Once Webhook has been created and added, there is no way to edit it. You need to delete it and create a new webhook with the correct URL.



For Zapier integration and tutorials about creating Zaps, read these articles:
โ€‹

Did this answer your question?