{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with SendGrid.",
  "vendor": "sendgrid",
  "name": "SendGrid",
  "official_docs": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/event",
  "docs_checked": "2026-10-28",
  "url": "https://hookdeck.com/webhooks/sendgrid",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/sendgrid"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/sendgrid/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/sendgrid/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/sendgrid/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/sendgrid/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/sendgrid/skill"
    }
  ],
  "summary": "SendGrid signs some webhooks with x-twilio-email-event-webhook-signature (ECDSA).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "x-twilio-email-event-webhook-signature",
      "detail": "Not every delivery is signed: check your setup.",
      "source": {
        "kind": "vendor-docs",
        "label": "SendGrid docs",
        "href": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook-security-features"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "ECDSA",
      "detail": "Asymmetric: verify with the vendor's public key.",
      "source": {
        "kind": "vendor-docs",
        "label": "SendGrid docs",
        "href": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook-security-features"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{timestamp}{raw body}",
      "detail": "The X-Twilio-Email-Event-Webhook-Timestamp value as sent, then the body's raw bytes, with nothing between them. The signature covers a SHA-256 hash of that.",
      "source": {
        "kind": "vendor-docs",
        "label": "SendGrid docs",
        "href": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook-security-features"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "event field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "SendGrid docs",
        "href": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/event"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "SendGrid docs",
        "href": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook"
      },
      "doc_discrepancy": null
    },
    {
      "key": "timestamp",
      "label": "Send timestamp",
      "value": "x-twilio-email-event-webhook-timestamp",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "SendGrid docs",
        "href": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook-security-features"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill sendgrid-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/sendgrid/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/event",
    "checked": "2026-07-29"
  },
  "counts": {
    "events": 12,
    "with_payload": 12,
    "captured": 0,
    "with_description": 12,
    "resources": 3,
    "confidence": {
      "verified": 0,
      "documented": 12,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any SendGrid event"
  },
  "events": [
    {
      "name": "processed",
      "resource": "delivery",
      "description": "SendGrid accepts a message for delivery",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#processed",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/processed.json"
    },
    {
      "name": "delivered",
      "resource": "delivery",
      "description": "Receiving mail server accepts the message",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#delivered",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/delivered.json"
    },
    {
      "name": "bounce",
      "resource": "delivery",
      "description": "Receiving server refuses the message, as a hard bounce or a block",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#bounce",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/bounce.json"
    },
    {
      "name": "deferred",
      "resource": "delivery",
      "description": "Receiving server temporarily refuses the message",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#deferred",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/deferred.json"
    },
    {
      "name": "dropped",
      "resource": "delivery",
      "description": "SendGrid drops the message, for example for a previously bounced address",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#dropped",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/dropped.json"
    },
    {
      "name": "open",
      "resource": "engagement",
      "description": "HTML message is opened, including Apple Mail Privacy Protection opens",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#open",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/open.json"
    },
    {
      "name": "click",
      "resource": "engagement",
      "description": "Recipient clicks a tracked link",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#click",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/click.json"
    },
    {
      "name": "unsubscribe",
      "resource": "engagement",
      "description": "Recipient opts out of all your email",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#unsubscribe",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/unsubscribe.json"
    },
    {
      "name": "spamreport",
      "resource": "engagement",
      "description": "Recipient reports the message as spam",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#spamreport",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/spamreport.json"
    },
    {
      "name": "group_unsubscribe",
      "resource": "engagement",
      "description": "Recipient leaves a single unsubscribe group",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#group_unsubscribe",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/group-unsubscribe.json"
    },
    {
      "name": "group_resubscribe",
      "resource": "engagement",
      "description": "Recipient rejoins a single unsubscribe group",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#group_resubscribe",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/group-resubscribe.json"
    },
    {
      "name": "account_status_change",
      "resource": "account_status_change",
      "description": "Compliance action changes your SendGrid account's status",
      "confidence": "documented",
      "schema_source": "from SendGrid docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/sendgrid/events#account_status_change",
      "json": "https://hookdeck.com/webhooks/sendgrid/events/account-status-change.json"
    }
  ]
}