Webhooks
Webhooks are currently triggered at the organization-wide level, meaning events for all domains your organization has set up with Paubox will trigger a webhook notification.
You can setup webhooks in the Paubox Dashboard.
Webhook fields
- URL: You will need to provide an HTTPS URL which you own, to which you would like your webhook payload to be sent.
- Event: The events notifications to which you would like to subscribe
Available events
| Event Name | Event Name Key Value | Trigger |
|---|---|---|
| Delivered | api_mail_log_delivered | When message is delivered |
| Temporary Failure | api_mail_log_temporary_failure | On soft bounce of message |
| Permanent Failure | api_mail_log_permanent_failure | On hard bounce of message |
| Opened | api_mail_log_opened | On opening of message |
Payloads
Every Webhook notification will include an event_name key and a payload key. The type of payload you should expect is dependent on the data model that is triggering the webhook event.
The most common type of payload is the API Mail Log payload, which is structured as follows: