JSON Lines Handler

Handle webhook events in JSON Lines format

Receive webhook events in JSON Lines format - one JSON object per line.

Set Payload format: JSON Lines in your webhook settings.

Receive events (JSON Lines)

Mailtrap sends a POST request to your webhook URL with events in JSON Lines format.

Each line is a separate JSON object. Parse line by line.

Your endpoint should:

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

Webhook setup guide

Payload

application/jsonl

or

Responses

200

Return 200 to acknowledge successful receipt

No content

500

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

Payload

{"event":"delivery","timestamp":1728669927,"sending_stream":"transactional","category":"Password reset","message_id":"1df37d17-0286-4d8b-8edf-bc4ec5be86e6","email":"[email protected]","event_id":"bede7236-2284-43d6-a953-1fdcafd0fdbc","sending_domain_name":"examplesender.com"}
{"event":"delivery","timestamp":1728669927,"sending_stream":"transactional","category":"Email confirmation","message_id":"ca7974af-7212-42aa-99fb-cc4742d0658b","email":"[email protected]","event_id":"657b8544-6a95-4c47-997f-6e47922a5052","sending_domain_name":"examplesender.com"}