Senlo
API reference

SendGrid webhook

POST
/api/webhooks/sendgrid

Paste this URL into a SendGrid Event Webhook with Signed Event Webhook turned on, and save its Verification Key on the provider in Senlo. Senlo verifies the ECDSA signature and the timestamp (at most 25 hours old), then applies delivered, bounce, spamreport and dropped events from the batch; a drop counts only for an address reason (Bounced Address, Invalid Address, Spam Reporting Address). Other event types are acknowledged and ignored.

Header Parameters

X-Twilio-Email-Event-Webhook-Signature*string

Base64 ECDSA signature of the timestamp followed by the raw body.

X-Twilio-Email-Event-Webhook-Timestamp*string

Request Body

The batch of events exactly as SendGrid sends it.

application/json
  1. body
[index: integer]?

Response Body

Accepted. Also returned for events Senlo ignores, so the provider stops retrying.

application/json
  1. response
success?boolean
Example Request
curl -X POST 'https://senlo.io/api/webhooks/sendgrid' \  -H 'X-Twilio-Email-Event-Webhook-Signature: string' \  -H 'X-Twilio-Email-Event-Webhook-Timestamp: string' \  -H 'Content-Type: application/json' \  -d '[  {}]'
Example Response
{  "success": true}