Webhooks
Signerte hendelser, i det øyeblikket de skjer.
Mailhuset forteller systemene dine så snart en melding er levert, returnert eller klaget på, eller åpnet og klikket når sporing er på, og signerer hver nyttelast så du kan verifisere at den kom fra oss før du handler på den.
X-Mailhuset-Signature: t=1718...,v1=3ba7...
{
"type": "email.delivered",
"id": "msg_a91f2c",
"to": "user@example.com",
"at": "2026-08-19T14:02:11Z"
}Hendelser du faktisk kan stole på
En webhook er bare nyttig hvis du kan stole på den og regne med at den kommer fram. Mailhuset signerer hver enkelt og prøver på nytt til endepunktet ditt bekrefter mottak.
Hver leveringshendelse
Levert, returnert, klaget, åpnet, klikket og mer sendes til endepunktet ditt så snart de inntreffer. Åpninger og klikk krever at sporing er på, noe utsendelser har som standard.
HMAC-signaturer
Hver nyttelast bærer en signatur du verifiserer med nøkkelen din, så en forfalsket forespørsel når aldri forretningslogikken din.
Nye forsøk med gradvis venting
Hvis endepunktet ditt er nede, prøver vi på nytt med gradvis lengre ventetid til det returnerer HTTP 200. Dermed går ikke hendelser tapt ved korte avbrudd.
Beskyttelse mot gjenspilling
Signaturer er tidsstemplet, så en fanget forespørsel kan ikke spilles av mot endepunktet ditt på et senere tidspunkt.
En leveringslogg
Se hvert forsøk, svaret og tidspunktet, så et endepunkt som oppfører seg dårlig er lett å oppdage og feilsøke.
Administrer endepunkter
Legg til, pause eller roter endepunkter og velg hvilke hendelsestyper hvert av dem mottar, alt fra dashbordet.
Vanlige spørsmål
- Hvordan verifiserer jeg at en webhook kom fra Mailhuset?
- Hver forespørsel inkluderer en HMAC-signatur og et tidsstempel. Beregn signaturen på nytt med signeringshemmeligheten din og sammenlign den før du stoler på nyttelasten.
- Hva skjer hvis endepunktet mitt er nede?
- Vi prøver på nytt med gradvis venting til endepunktet ditt returnerer en 200, og leveringsloggen viser hvert forsøk så ingenting går tapt i stillhet.
- Kan jeg velge hvilke hendelser jeg mottar?
- Ja. Hvert endepunkt abonnerer på hendelsestypene du velger, så du får bare det du håndterer.
Relatert lesing
Koble appen din til hver sending
Legg til et endepunkt, verifiser en signatur og begynn å motta signerte leveringshendelser på få minutter.