Create a rotation

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 a new empty rotation for a schedule. After creating a rotation, add events to define the on-call pattern.

Note: Rotations have no configuration of their own — all scheduling logic (recurrence, assignment strategy, members) is specified on events. The request body must be empty or {}.

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.

Empty body — rotations carry no configuration at creation time

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/v3/schedules/PSJUKNI/rotations" \  -H "Content-Type: application/json" \  -d '{}'

{  "rotation": {    "id": "ABCDEFGHIJKLMNOPQRSTUVWXY2",    "type": "schedule_rotation",    "events": [      {        "id": "ABCDEFGHIJKLMNOPQRSTUVWXY2",        "type": "schedule_event",        "name": "Weekly On-Call",        "start_time": {          "date_time": "2025-03-03T09:00:00Z",          "time_zone": "America/New_York"        },        "end_time": {          "date_time": "2025-03-03T09:00:00Z",          "time_zone": "America/New_York"        },        "effective_since": "2025-03-03T00:00:00Z",        "effective_until": "2025-09-01T00:00:00Z",        "recurrence": [          "RRULE:FREQ=WEEKLY"        ],        "assignment_strategy": {          "type": "rotating_member_assignment_strategy",          "shifts_per_member": 1,          "members": [            {              "type": "user_member",              "user_id": "PUSER123"            }          ]        },        "self": "http://example.com",        "html_url": "http://example.com"      }    ],    "self": "http://example.com",    "html_url": "http://example.com"  }}

Create a rotation

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`