Create a User Handoff Notification Rule

Create a new Handoff Notification Rule. Users are members of a PagerDuty account that have the ability to interact with Incidents and other data on the account. For more information see the API Concepts Document

Scoped OAuth requires: users.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

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

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Request Body

application/json

The Handoff Notification Rule to be created.

TypeScript Definitions

Use the request body type in TypeScript.

oncall_handoff_notification_rule*

A rule for contacting the user for Handoff Notifications.

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/users/{id}/oncall_handoff_notification_rules" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "oncall_handoff_notification_rule": {      "id": "PXPGF43",      "handoff_type": "both",      "notify_advance_in_minutes": 180,      "contact_method": {        "id": "PXPGF42",        "type": "email_contact_method"      }    }  }'

{  "oncall_handoff_notification_rule": {    "id": "PXPGF42",    "handoff_type": "both",    "notify_advance_in_minutes": 180,    "contact_method": {      "id": "PXPGF42",      "type": "email_contact_method_reference",      "summary": "Work",      "self": "https://api.pagerduty.com/users/PXPGF42/contact_methods/PXPGF42"    }  }}

Create a User Handoff Notification Rule

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

402application/json

403application/json

429application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`