younifyd
Menu

Create Incident Notification Subscribers

Add Notification Subscribers

POST/incidents/{id}/status_updates/subscribers

Use it in a workflow

  1. Add a step and choose the PagerDuty connector.
  2. Pick the Create Incident Notification Subscribers action (under Incidents).
  3. Fill in the fields below, then reference the result from later steps as {{createIncidentNotificationSubscribers.response.data}}.

Request

Path parameters

idstringrequired

The ID of the resource.

Headers

Acceptstringrequired

The `Accept` header is used as a versioning header.

Default "application/vnd.pagerduty+json;version=2"

Request body

Enter the body as JSON in the step's Body field.

subscribersarray<object>required
subscriber_idstring

The ID of the entity being subscribed

subscriber_typestring

The type of the entity being subscribed

One ofuserteam

json
{
  "subscribers": [
    {
      "subscriber_id": "PD1234",
      "subscriber_type": "user"
    }
  ]
}

Response

Returns 200 with an object. Read it in later steps with {{createIncidentNotificationSubscribers.response.data.<field>}}.

subscriptionsarray<object>
subscriber_idstring

The ID of the entity being subscribed

subscriber_typestring

The type of the entity being subscribed

One ofuserteam

subscribable_idstring

The ID of the entity being subscribed to

subscribable_typestring

The type of the entity being subscribed to

One ofincidentbusiness_service

account_idstring

The type of the entity being subscribed to

resultstring

The resulting status of the subscription

One ofsuccessduplicateunauthorized

json
{
  "subscriptions": [
    {
      "subscriber_id": "string",
      "subscriber_type": "user",
      "subscribable_id": "string",
      "subscribable_type": "incident",
      "account_id": "string",
      "result": "success"
    }
  ]
}

Need more? See the PagerDuty guide for connection setup and behaviour shared by every action.

Create Incident Notification Subscribers — PagerDuty — Documentation