Create a webhook

POST/v1/webhooks

Sends signed events to your endpoint when inboxes, domains or IPs change.

Parameters

urlstringRequired: An HTTPS URL on your side.
eventsarrayRequired: For example inbox.ready, ip.listed, domain.verified.

curl -X POST https://api.mailyard.com/v1/webhooks \
  -H "Authorization: Bearer $MAILYARD_KEY" \
  -d url='https://app.yours.com/hooks' \
  -d events='["inbox.ready"]'

Response201 Created

{
  "data": {
    "id": "wh_91kd2",
    "secret": "whsec_…",
    "events": ["inbox.ready", "ip.listed"]
  }
}