Why Webhooks?
Through Webhooks, you can send HTTP requests to a third-party application every time when an event or action occurs on your application.
Simply put, when an event happens in your webpage, you can notify a third party application automatically without continuously polling for data.
Let’s say you have an e-commerce website and you have a billing application integrated with your application. So every time when a purchase happens, you can notify the billing system automatically using their webhook URL.
Freshmarketer Webhooks:
Using Freshmarketer Webhooks, you can automatically push data to your application through which you can have a simple one to one connection that runs automatically.
Whenever an event occurs in Freshmarketer, a POST event will be sent in a JSON format to the Webhook URL you’ve configured.
The URL will be called automatically every time when a specified action/event happens for the contacts in Freshmarketer. For example, whenever a new contact is added, you can configure Freshmarketer to push data to your application’s webhook URL automatically.
Configure Webhooks in Freshmarketer:
Drag and drop the Webhooks block that’s under the Actions.
Click on ‘Choose or Create a Webhook’. The below popup will be shown providing the option to choose from the list of available webhooks or create a new one.
Click ‘Create New Webhook’.
A popup window will be loaded where you can configure your Webhook URL’s details.
Webhook name: Provide a name for the Webhook
URL: Input your webhook URL. If there are any required parameters on your URL, you can add them as a placeholder using the below option.
Required Authentication:
If your third-party application URL is protected and requires authentication, you can authenticate using two ways. Through Basic, you can pass a Username and Password and through Token, a token or API key can be passed to authenticate and help access the URL.
Add Custom Header:
If your Webhook URL requires any additional information with the content such as security information, etc. those can be added as custom headers by enabling this option.
Add custom payload:
Apart from default event trigger information, you can add your own custom contact/event properties in your payload as well. Those events will be sent as JSON data on the HTTP request body.
Sample Payload:
"Headers": {
"Content-Type": "application/json;charset=UTF-8"
},
"Body": {
"event_type": "List",
"data": {
"contact": {
"first name": "test_contact_fname",
"mobile": "1234567890",
"email": "testuser@freshmarketer.com"
},
"event_details": {
"list_id": "100",
"contact_id": "200"
},
"custom_data": {
"name": "test_contact_fname",
"salary": "123",
"age": "12"
}
},
"id": "7c076336-6072-4be3-a86f-b7255dbd0d63",
"event": "list.add_contact",
"event_category": "system",
"event_time": 1563186327795
}
}
Test your Webhooks:
You can test your Webhook URL with sample data. The response status received should be 200 and any other response other than that is considered as a failure. This helps you identify if your Webhook URL is valid or not.
Click on 'Create Webhook' once the configuration is completed.
Sample Journey using Webhooks:
Here the Webhook URL will be called whenever the contacts from the list ‘Test’ clicks on the email campaign ‘Sample’ that has been sent.
