Developers
Webhooks
Get notified in real time when emails are delivered, opened, clicked, or bounced. Register an endpoint, verify signatures, and keep your systems in sync.
HMAC verification
Every payload is signed with your webhook secret using HMAC-SHA256. Verify the X-Artmail-Signature header to ensure authenticity.
Automatic retries
Failed deliveries are retried with exponential backoff — up to 5 attempts over 24 hours. Check delivery logs in the dashboard.
Near real-time
Events are dispatched within seconds of occurrence. Batch events are grouped to minimize requests to your endpoint.
Supported events
email.sentEmail accepted by SES for delivery
email.deliveredEmail successfully delivered to the recipient
email.openedRecipient opened the email
email.clickedRecipient clicked a link in the email
email.bouncedEmail bounced (hard or soft)
email.complainedRecipient marked the email as spam
email.unsubscribedRecipient unsubscribed via the link
contact.createdA new contact was added
contact.updatedContact profile or tags changed