From the application
- Open Settings → Webhooks and click Create a webhook.
- Enter the notification URL: an
https://address reachable from the Internet (local or private addresses are refused). It must answer within 10 seconds. - Tick the events to receive (full list) and confirm.
The signing secret is shown only once. Copy it right away into a password manager: it is what lets you verify that calls really come from Mailpro. Lost it? Use “Rotate the secret”.
The webhook becomes active about 10 minutes after creation, while our servers synchronise.
Testing
In the list, More actions → Send a test ping: pick an event type and a sample payload is sent to your URL immediately. View delivery history shows every attempt (date, HTTP status, latency, attempt number) and lets you replay a delivery.
From the API
The same operations exist for your integrations: POST /api/v3/Webhook (creation, returns the secret once), POST /api/v3/Webhook/{id}/test, GET /api/v3/Webhook/{id}/deliveries, POST /api/v3/Webhook/{id}/rotate-secret, DELETE /api/v3/Webhook/{id}. Details and examples in the developer portal.
Limits
- 20 webhooks per account, 50 events per webhook.
- A disabled webhook (manually, or after 10 consecutive failures) is re-enabled with one click: what happens on failure?
- Deleting a webhook also deletes its delivery history, permanently.