EventWebhookUnsignedResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sendgrid/main/json-schema/sendgrid-event-webhook-unsigned-response-schema.json",
  "title": "EventWebhookUnsignedResponse",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sendgrid-event-webhook-api-openapi.yml#/components/schemas/EventWebhookUnsignedResponse",
  "type": "object",
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Indicates if the Event Webhook is enabled."
    },
    "url": {
      "type": "string",
      "description": "The URL where SendGrid will send event data."
    },
    "account_status_change": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send account status change events related to compliance action taken by SendGrid."
    },
    "group_resubscribe": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send group resubscribe events. Group resubscribes occur when recipients resubscribe to a specific [unsubscribe group](https://docs.sendgrid.com/ui/sending-email/create-and-manage-unsubscribe-groups) by updating their subscription preferences. You must [enable Subscription Tracking](https://docs.sendgrid.com/ui/account-and-settings/tracking#subscription-tracking) to receive this type of event."
    },
    "delivered": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send delivered events. Delivered events occur when a message has been successfully delivered to the receiving server."
    },
    "group_unsubscribe": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send group unsubscribe events. Group unsubscribes occur when recipients unsubscribe from a specific [unsubscribe group](https://docs.sendgrid.com/ui/sending-email/create-and-manage-unsubscribe-groups) either by direct link or by updating their subscription preferences. You must [enable Subscription Tracking](https://docs.sendgrid.com/ui/account-and-settings/tracking#subscription-tracking) to receive this type of event."
    },
    "spam_report": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send spam report events. Spam reports occur when recipients mark a message as spam."
    },
    "bounce": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send bounce events. A bounce occurs when a receiving server could not or would not accept a message."
    },
    "deferred": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send deferred events. Deferred events occur when a recipient's email server temporarily rejects a message."
    },
    "unsubscribe": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send unsubscribe events. Unsubscribes occur when recipients click on a message's subscription management link. You must [enable Subscription Tracking](https://docs.sendgrid.com/ui/account-and-settings/tracking#subscription-tracking) to receive this type of event."
    },
    "processed": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send processed events. Processed events occur when a message has been received by Twilio SendGrid and is ready to be delivered."
    },
    "open": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send open events. Open events occur when a recipient has opened the HTML message. You must [enable Open Tracking](https://docs.sendgrid.com/ui/account-and-settings/tracking#open-tracking) to receive this type of event."
    },
    "click": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send click events. Click events occur when a recipient clicks on a link within the message. You must [enable Click Tracking](https://docs.sendgrid.com/ui/account-and-settings/tracking#click-tracking) to receive this type of event."
    },
    "dropped": {
      "type": "boolean",
      "description": "Indicates if the webhook is configured to send dropped events. Dropped events occur when your message is not delivered by Twilio SendGrid. Dropped events are accomponied by a `reason` property, which indicates why the message was dropped. Reasons for a dropped message include: Invalid SMTPAPI header, Spam Content (if spam checker app enabled), Unsubscribed Address, Bounced Address, Spam Reporting Address, Invalid, Recipient List over Package Quota."
    },
    "friendly_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "An optional friendly name assigned to the Event Webhook to help you differentiate it. The friendly name is for convenience only. You should use the webhook `id` property for any programmatic tasks."
    },
    "id": {
      "type": "string",
      "description": "A unique string used to identify the webhook. A webhook's ID is generated programmatically and cannot be changed after creation. You can assign a natural language identifier to your webhook using the `friendly_name` property."
    },
    "created_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "An ISO 8601 timestamp in UTC timezone when the Event Webhook was created. If a Webhook's `created_date` is `null`, it is a [legacy Event Webook](https://www.twilio.com/en-us/changelog/event-webhooks), which means it is your oldest Webhook.",
      "format": "date-time"
    },
    "updated_date": {
      "type": "string",
      "description": "An ISO 8601 timestamp in UTC timezone when the Event Webhook was last modified.",
      "format": "date-time"
    },
    "oauth_client_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The OAuth client ID SendGrid sends to your OAuth server or service provider to generate an OAuth access token."
    },
    "oauth_token_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "The URL where SendGrid sends the OAuth client ID and client secret to generate an access token. This should be your OAuth server or service provider."
    }
  }
}