Docs / Vendor onboarding

Connect SendGrid webhooks to Relin

Use this when SendGrid should stream email delivery and engagement events into your product. Relin records each Event Webhook request, verifies signed Event Webhooks when you provide the public key, and lets you inspect or replay batches.

Open Relin workspace Open SendGrid Event Webhook docs

What you need

Relin access

Owner or admin access to the Relin workspace where events should land.

SendGrid access

Admin access to the SendGrid account or app where you configure webhooks.

Test event

A safe SendGrid test event or development account you can use before production traffic.

1. Create the SendGrid source in Relin

  1. In Relin, open Developer → Inbound.
  2. Click Add source.
  3. Select the SendGrid tile.
  4. Name the source, for example SendGrid events.
  5. Save the source and copy the ingest URL. You will paste this URL into SendGrid.
Relin source picker with SendGrid selected
Select SendGrid from the source picker, then name the source after the SendGrid account or subuser.

2. Configure SendGrid

  1. Open SendGrid Settings, then Mail Settings.
  2. Under Webhook Settings, open Event Webhooks.
  3. Create a new webhook or edit an existing one.
  4. Paste the Relin ingest URL into Post URL.
  5. Choose the delivery and engagement events you want SendGrid to post.
  6. Enable signature verification if you want Relin to verify requests.
  7. Save the Event Webhook.

Recommended SendGrid events

Delivery

processed
delivered
deferred
bounce
dropped

Engagement

open
click
unsubscribe
spamreport

3. Copy the SendGrid public key into Relin

  1. Open the Event Webhook security settings in SendGrid.
  2. Copy the public key generated for Signed Event Webhook verification.
  3. Return to the Relin source settings page and paste it into Signing secret.
  4. Save the source.
Relin source created panel for SendGrid
After the source is created, copy the ingest URL before leaving the page. The token is shown once.

4. Send a test event

  1. Use SendGrid's Test Your Integration action for the Event Webhook.
  2. Open Relin Events and filter to the SendGrid source.
  3. Confirm the request arrived and signature status is verified when signing is enabled.

SendGrid notes

  • SendGrid Event Webhook requests are batches. Relin records the whole batch request.
  • Signed Event Webhooks use public-key verification, so paste the public key, not an API key.

Troubleshooting

  • No event in Relin: confirm the Post URL is the Relin ingest URL and the webhook is enabled.
  • Signature failed: confirm you copied the public key from the same Event Webhook configuration.
  • Events seem grouped: SendGrid can send multiple email events in one request batch.

Official references

Next