Create a Slack Connection

Creates a Slack Connection

Important

Make sure that your PagerDuty account is linked to your Slack workspace and your PagerDuty user is linked to your Slack user. You can do this on the Slack extension page in your PagerDuty account.

Scoped OAuth requires: services.read users.read webhook_subscriptions.write priorities.read incidents.read

Authorization

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

slack_team_id*string

Slack team (workspace) id

slack_team_id*string

Slack team (workspace) id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

slack_connection?

Response Body

`application/json`

curl -X POST "https://example.com/workspaces/{slack_team_id}/connections" \  -H "Content-Type: application/json" \  -d '{    "slack_connection": {      "source_id": "A1234B5",      "source_type": "team_reference",      "channel_id": "A123B456C7D",      "notification_type": "responder",      "config": {        "events": [          "incident.triggered",          "incident.acknowledged",          "incident.escalated",          "incident.resolved",          "incident.reassigned",          "incident.annotated",          "incident.unacknowledged",          "incident.delegated",          "incident.priority_updated",          "incident.responder.added",          "incident.responder.replied",          "incident.status_update_published"        ],        "priorities": [          "ABCDEF1",          "AB1CDE2"        ],        "urgency": null      }    }  }'

{  "slack_connection": {    "id": "A12BCDE",    "source_id": "A1234B5",    "source_name": "test_team",    "source_type": "team_reference",    "channel_id": "A123B456C7D",    "channel_name": "random",    "notification_type": "responder",    "config": {      "events": [        "incident.triggered",        "incident.acknowledged",        "incident.escalated",        "incident.resolved",        "incident.reassigned",        "incident.annotated",        "incident.unacknowledged",        "incident.delegated",        "incident.priority_updated",        "incident.responder.added",        "incident.responder.replied",        "incident.status_update_published"      ],      "priorities": [        "ABCDEF1",        "AB1CDE2"      ],      "urgency": null    }  }}

Create a Slack Connection

Important

Authorization

Path Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`