Source type

SendGrid Source Configuration

SendGrid sources receive signed Event Webhook traffic for delivered, bounced, opened, clicked, deferred, and processed email events.

SENDGRIDPOST, PUT, PATCH, DELETEPublic Verification KeyEmail and messaging
SendGrid Event Webhook security documentationAll source types
SendGrid sends webhook traffic to a FastHook source, FastHook validates the provider contract, records the request, and routes accepted events through connections to destinations.SendGridProviderPOST, PUT, PATCH, DELETESignedFastHookSource URLSENDGRIDProvider credentialpublic keyVerify before queue401 on auth failure405 on wrong methodAcceptedRequestverified: trueConnections route the accepted request to destinationsFilters, transformations, retries, replay, and destination signatures stay downstream from source verification.

SendGrid configuration

Create a SendGrid source, keep POST and PUT and PATCH and DELETE enabled, and provide the configured Public Verification Key values for provider signature. FastHook uses these settings to validate each SendGrid delivery before it enters the routing workflow.

Source Type

SENDGRID

Allowed methods

POST, PUT, PATCH, DELETE

Authentication

Provider signature

Credential fields

Public Verification Key

SendGrid source config
{
  "type": "SENDGRID",
  "config": {
    "auth_type": "PROVIDER_SIGNATURE",
    "auth": {
      "provider": "SENDGRID",
      "public_key": "-----BEGIN PUBLIC KEY-----..."
    },
    "allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
  }
}

SendGrid request contract

FastHook verifies the ECDSA P-256 signature over timestamp + raw body using the configured public verification key.

POSTPUTPATCHDELETE

SendGrid headers

Preserve x-twilio-email-event-webhook-signature, x-twilio-email-event-webhook-timestamp when sending SendGrid test deliveries. FastHook evaluates this request context before accepting the payload, so missing or modified values remain visible as rejected requests instead of routed events.

x-twilio-email-event-webhook-signature

ECDSA signature.

x-twilio-email-event-webhook-timestamp

Timestamp prepended to the raw body before verification.

SendGrid setup

  1. Enable signed Event Webhook delivery in SendGrid.
  2. Copy the public verification key into FastHook.
  3. Keep the raw request body available if your destination also validates SendGrid.

Continue with SendGrid