/
/TempMailGrab API
ChangesDocsSign in
  • Docs
  • History
  • Schema
  • post/inboxCreate a disposable inbox
  • delete/inbox/{id}Delete an inbox and all of its mail
  • get/inbox/{id}/messagesList messages (newest first)
  • delete/inbox/{id}/messagesDelete every message in an inbox, keeping the address
  • get/inbox/{id}/messages/{mid}Fetch one full message
  • post/inbox/{id}/test-messageInject a synthetic message through the parsing and realtime pipeline
  • get/messagesList messages using the flat endpoint alias
  • get/messages/{id}Fetch one message by ID (flat alias)
  • post/inbox/{id}/webhookRegister a delivery webhook for one inbox
  • get/webhooksList account webhooks
  • post/webhooksRegister an account webhook (fires for every inbox)
  • delete/webhooks/{id}Delete an account webhook
  • get/byodList custom domains registered to this API key
  • post/byodRegister a custom domain and receive its DNS requirements
  • post/byod/{domain}/verifyVerify custom-domain TXT ownership and MX routing
Webhooks
  • postmessageReceivedA parsed message was received

A parsed message was received

Signed with HMAC-SHA256 in X-TMG-Signature using the secret returned when the webhook was created.

postWebhookmessageReceived

Headers

X-TMG-Signaturestring required

Payload

event'email.received' required
sent_atinteger required

Unix timestamp in seconds.

Response

Return any 2xx response to acknowledge delivery.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.