Set up webhooks

Webhooks push campaign events to your endpoint as they happen — no polling.

Supported events

campaign_sent · campaign_opened · campaign_clicked · unsubscribe · campaign_error · spam · hard_bounce

Create a webhook

curl --request POST \
  --url https://cloudapi.mailercloud.com/v1/webhooks \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "CRM sync",
    "url": "https://yourapp.com/hooks/mailercloud",
    "events": ["campaign_sent", "campaign_opened", "hard_bounce", "unsubscribe"]
  }'

Your endpoint should return a 2xx status quickly; do any heavy processing asynchronously.

Test it

Fire a sample payload at your endpoint before going live with Test webhook, and pause/resume delivery any time with Toggle webhook status.

Typical uses

Sync unsubscribes and hard bounces back to your CRM so you stop emailing dead addresses everywhere
Trigger in-app flows when a customer opens or clicks a campaign
Alert your team on campaign_error events

Sync contacts in real time Connect forms to your audience

⌘I

Getting Started

Guides

Supported events

Create a webhook

Test it

Typical uses

​Supported events

​Create a webhook

​Test it

​Typical uses

Supported events

Create a webhook

Test it

Typical uses