Create custom shifts

Important note: Shift-based schedules use the V3 API and are not compatible with V2 automations. To create automations for Shift-Based Schedules, you need to:

Update your automations to use the V3 API for all new shift-based schedules

Keep the V2 endpoint for your existing schedules

An upgrade tool for existing schedules is coming soon; your legacy schedules will keep working in the meantime. Learn more.

Create one or more custom shifts for a schedule. Custom shifts are ad-hoc one-off coverage periods that exist outside of rotation events.

Each custom shift requires exactly one assignment.

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the schedule.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

custom_shifts*array<>

Items1 <= items

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/v3/schedules/PSJUKNI/custom_shifts" \  -H "Content-Type: application/json" \  -d '{    "custom_shifts": [      {        "type": "custom_shift",        "start_time": "2025-03-15T09:00:00Z",        "end_time": "2025-03-15T17:00:00Z",        "assignments": [          {            "type": "shift_assignment",            "member": {              "type": "user_member",              "user_id": "PUSER123"            }          }        ]      }    ]  }'

{  "custom_shifts": [    {      "id": "string",      "type": "custom_shift",      "start_time": "2025-03-15T09:00:00Z",      "end_time": "2025-03-15T17:00:00Z",      "assignments": [        {          "id": "string",          "type": "shift_assignment",          "member": {            "type": "user_member",            "user_id": "PUSER123"          }        }      ],      "self": "http://example.com",      "html_url": "http://example.com"    }  ]}

Create custom shifts

Authorization

Path Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`