v1

latestOpenAPI 3.0.22026-07-144652931.4 MB

Webhooks

Create a webhook subscription

Creates a new webhook subscription.

For more information on webhook subscriptions and how they are used to configure v3 webhooks see the Webhooks v3 Developer Documentation.

Scoped OAuth requires: webhook_subscriptions.write

post/webhook_subscriptions

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Request body

Example request

{
  "webhook_subscription": {
    "oauth_client": {
      "id": "AGMEB7F7YJYELCPG4Y5YWMYGXE",
      "type": "oauth_client_reference",
      "summary": "PagerDuty Webhook Integration"
    }
  }
}

Response

The webhook subscription that was created.

Example response

{
  "webhook_subscription": {
    "oauth_client": {
      "id": "AGMEB7F7YJYELCPG4Y5YWMYGXE",
      "type": "oauth_client_reference",
      "summary": "PagerDuty Webhook Integration"
    }
  }
}