Webhook Integration in Settings
You can integrate webhooks in your account-level setting to get notified of any changes to the contacts. For detailed information, see HTTP Post URL.
Webhook Integration in Contact Lists
You can integrate webhooks in your lists to get notified of any changes to the subscription status of contacts in the lists. The webhook is fired when a contact is added to the list and also when the subscription status of contacts within the list changes.
When creating a new list or editing an existing list, enter the webhook API endpoint in the Post URL field.
The following is an example of the JSON payload that was sent after a contact subscribed to the list:
{
"subscriptions": [
{
"list_id": 1248,
"list": "tester sk",
"status": "Subscribed"
},
{
"list_id": 1275,
"list": "sk test list",
"status": "Subscribed"
}
],
"changed_attributed": {
"id": 12944266,
"account_id": 1000,
"list_id": 1275,
"contact_id": 12407494,
"active": true,
"status": 0,
"created_at": "2020-10-08T11:58:11.000-04:00",
"updated_at": "2020-10-08T11:58:11.000-04:00"
},
"status_code": 0,
"active": true,
"list": "sk test list",
"list_id": 1275,
"status": "Subscribed",
"contact": {
"1234": "abc",
"id": 12407494,
"account_id": 1000,
"email": "sonakshi@yopmail.com",
"first_name": "Maropost",
"last_name": "",
"domain_name_id": 8924,
"created_at": "2020-10-08T06:58:38.000-04:00",
"updated_at": "2020-10-08T06:58:41.000-04:00",
"age": null,
"language": "english",
"favourite_colour": null,
"vacation_spot": null,
"shirt_size": "Free Size",
"custom_field_001": false,
},
"tags": []
}
Ensuring Security When Using Webhooks
By default, Maropost does not include any authentication token in its webhook callbacks to your API endpoint. If you want to ensure stronger security, you can create a JSON Web Token that will then be included in all your webhook callbacks. The JSON Web Token can be created on the Connections page. For more information on JSON Web Token and steps to create it, see JSON Web Tokens (JWTs).