JSON Handler

Handle webhook events in JSON format

Receive webhook events as a JSON object containing an array of events.

Set Payload format: JSON in your webhook settings.

Receive events (JSON)

Mailtrap sends a POST request to your webhook URL with events as a JSON object.

Your endpoint should:

• Accept Content-Type: application/json
• Return HTTP 200 to acknowledge receipt
• Process events asynchronously

Webhook setup guide

Payload

application/json

Responses

200

Return 200 to acknowledge successful receipt

No content

500

Any other status triggers retry (40 retries every 5 min)

Payload

{
  "events": [
    {
      "event": "delivery",
      "timestamp": 1728669700,
      "sending_stream": "transactional",
      "category": "Password reset",
      "custom_variables": {
        "user_id": "123"
      },
      "message_id": "1df37d17-0286-4d8b-8edf-bc4ec5be86e6",
      "email": "[email protected]",
      "event_id": "bede7236-2284-43d6-a953-1fdcafd0fdbc",
      "sending_domain_name": "examplesender.com"
    }
  ]
}