PAGERDUTY_CREATE_NEW_WEBHOOK_SUBSCRIPTION

Creates a new webhook subscription in PagerDuty to receive specific event notifications. This endpoint allows users to set up automated notifications for various incident-related events, such as triggers, acknowledgments, and resolutions. The webhook can be configured to filter events by service, team, or account-wide, and supports custom HTTP headers for enhanced integration capabilities. Use this when you need to integrate PagerDuty's real-time incident updates with external systems or workflows. Note that the webhook's secret for payload verification is only provided in the initial creation response and cannot be retrieved later.

Available from 1 provider (1 remote)

Input Schema

            {
  "type": "object",
  "properties": {
    "webhook__subscription__id": {
      "type": "string",
      "title": "Webhook  Subscription  Id",
      "description": "Id"
    },
    "webhook__subscription__type": {
      "enum": [
        "webhook_subscription"
      ],
      "type": "string",
      "title": "Webhook  Subscription  Type",
      "default": "webhook_subscription",
      "description": "The type indicating the schema of the object."
    },
    "webhook__subscription__active": {
      "type": "boolean",
      "title": "Webhook  Subscription  Active",
      "default": true,
      "description": "Determines whether this subscription will produce webhook events."
    },
    "webhook__subscription__events": {
      "type": "array",
      "items": {
        "type": "string",
        "properties": {}
      },
      "title": "Webhook  Subscription  Events",
      "description": "The set of outbound event types the webhook will receive."
    },
    "webhook__subscription__filter__id": {
      "type": "string",
      "title": "Webhook  Subscription  Filter  Id",
      "description": "The id of the object being used as the filter.  This field is required for all filter types except account_reference. "
    },
    "webhook__subscription__description": {
      "type": "string",
      "title": "Webhook  Subscription  Description",
      "description": "A short description of the webhook subscription."
    },
    "webhook__subscription__filter__type": {
      "enum": [
        "account_reference",
        "service_reference",
        "team_reference"
      ],
      "type": "string",
      "title": "Webhook  Subscription  Filter  Type",
      "description": "The type of object being used as the filter."
    },
    "webhook__subscription__delivery__method__id": {
      "type": "string",
      "title": "Webhook  Subscription  Delivery  Method  Id",
      "description": "Id"
    },
    "webhook__subscription__delivery__method__url": {
      "type": "string",
      "title": "Webhook  Subscription  Delivery  Method  Url",
      "format": "url",
      "description": "The destination URL for webhook delivery."
    },
    "webhook__subscription__delivery__method__type": {
      "enum": [
        "http_delivery_method"
      ],
      "type": "string",
      "title": "Webhook  Subscription  Delivery  Method  Type",
      "default": "http_delivery_method",
      "description": "Indicates the type of the delivery method."
    },
    "webhook__subscription__delivery__method__secret": {
      "type": "string",
      "title": "Webhook  Subscription  Delivery  Method  Secret",
      "description": "The secret used to sign webhook payloads. Only provided on the initial create response. "
    },
    "webhook__subscription__delivery__method__custom__headers": {
      "type": "array",
      "items": {
        "type": "object",
        "title": "CustomHeadersRequest",
        "properties": {
          "name": {
            "type": "string",
            "title": "Name",
            "description": "The header name"
          },
          "value": {
            "type": "string",
            "title": "Value",
            "description": "The header value"
          }
        },
        "description": "Request schema for `CustomHeaders`"
      },
      "title": "Webhook  Subscription  Delivery  Method  Custom  Headers",
      "description": "Optional headers to be set on this webhook subscription when sent. The header values are redacted in GET requests, but are not redacted on the webhook when delivered to the webhook\"s endpoint. "
    },
    "webhook__subscription__delivery__method__temporarily__disabled": {
      "type": "boolean",
      "title": "Webhook  Subscription  Delivery  Method  Temporarily  Disabled",
      "description": "Whether or not this webhook subscription is temporarily disabled. Becomes `true` if the delivery method URL is repeatedly rejected by the server. "
    }
  }
}