Create a schedule

<!-- theme: info -->

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:

1. Update your automations to use the V3 API for all new shift-based schedules
2. 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 on-call schedule with basic metadata. Rotations and events must be added via separate API calls after creation.

Rejected fields: rotations and escalation_policies are not accepted in the request body and will result in a 400 error.

{
  "schedule": {
    "name": "Engineering On-Call",
    "time_zone": "America/New_York",
    "description": "Primary engineering on-call rotation"
  }
}