v1

latestOpenAPI 3.0.22026-07-144652931.4 MB

Webhooks

Create an OAuth client

Create a new OAuth client for webhook subscriptions. The client credentials will be validated by attempting to obtain an access token before creation.

Requires admin or owner role permissions.

Maximum of 10 OAuth clients per account.

post/webhook_subscriptions/oauth_clients

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Request body

Example request

{
  "oauth_client": {
    "name": "PagerDuty Webhook Integration",
    "client_id": "oauth-client-id",
    "client_secret": "oauth-secret-id",
    "scope": "read write",
    "token_url": "https://foo.oauth-server.com/oauth_token.do",
    "grant_type": "client_credentials"
  }
}

Response

OAuth client created successfully

Example response

{
  "oauth_client": {
    "id": "AGMEB7F7YJYELCPG4Y5YWMYGXE",
    "type": "oauth_client",
    "name": "PagerDuty Webhook Integration",
    "client_id": "oauth-client-id",
    "scope": "read write",
    "token_url": "https://foo.oauth-server.com/oauth_token.do",
    "grant_type": "client_credentials",
    "status": "active"
  }
}