Webhook in uscita

Eventi, registrazione endpoint e retry.

I webhook notificano il tuo server quando avvengono eventi in MailingCore (invio, apertura, bounce, disiscrizione, ecc.).

Scope richiesto sulla API key: webhooks:manage.

Registrare un endpoint

POST /webhooks/endpoints
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

{
  "url": "https://tua-app.com/webhooks/mailingcore",
  "events": ["email.sent", "email.bounced", "contact.unsubscribed"],
  "secret": "whsec_opzionale_o_generato"
}

La risposta include il secret per verificare le firme HMAC.

Gestione

Azione	Endpoint
Elencare	`GET /webhooks/endpoints`
Attivare/disattivare	`PATCH /webhooks/endpoints/:id/toggle`
Vedere consegne	`GET /webhooks/endpoints/:id/deliveries`
Eliminare	`DELETE /webhooks/endpoints/:id`

Eventi disponibili

email.sent, email.delivered, email.opened, email.clicked
email.bounced, email.complained, email.failed
contact.unsubscribed

Consegna

Gli eventi vengono accodati in mc:webhook-delivery con retry. Ogni richiesta include l'header di firma:

X-MailingCore-Signature: t=1719763200,v1=abc123...

Vedi Verificare firma HMAC.