---
title: "Create a Schedule"
method: POST
path: "/v2/schedules/{destination}"
tags: ["Schedules"]
---

# Create a Schedule

`POST /v2/schedules/{destination}`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/schedules/{destination}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/qstash-rest-api/docs/v2/schedules/:destination/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a schedule to send messages periodically

## Path parameters

- `destination` string, required

## Headers

- `Upstash-Cron` string, required
- `Upstash-Schedule-Id` string
- `Content-Type` string
- `Upstash-Method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
- `Upstash-Timeout` string
- `Upstash-Retries` integer
- `Upstash-Retry-Delay` string
- `Upstash-Delay` string
- `Upstash-Forward-*` string
- `Upstash-Callback` string
- `Upstash-Callback-Forward-*` string
- `Upstash-Callback-*` string
- `Upstash-Failure-Callback` string
- `Upstash-Failure-Callback-Forward-*` string
- `Upstash-Failure-Callback-*` string
- `Upstash-Redact-Fields` string
- `Upstash-Label` string

## Request body

- object

## Response `200`

Schedule created successfully

- object
  - `scheduleId` string: Unique identifier for the schedule

## Other responses

- `400`: Schedule ID is invalid. Schedule IDs can only contain alphanumeric characters, hyphens, periods, and underscores.
- `412`: Exceeded the maximum number of schedules allowed.

## Changes

- **2026-06-09** `d30bd0904328`: 1 info
  - added the new optional `header` request parameter `Upstash-Label`
- **2026-06-09** `d859c277ced2`: 1 warning
  - deleted the `header` request parameter `Upstash-Label`
- **2026-05-15** `75ecd1c6fb73`: 1 info
  - added the new optional `header` request parameter `Upstash-Label`
- **2026-03-30** `55b7351a774d`: 1 info
  - added the new optional `header` request parameter `Upstash-Redact-Fields`

[Operation history](https://skmtc.dev/upstash/apis/qstash-rest-api/changes/v2/schedules/:destination/post.md)

---

[API](https://skmtc.dev/upstash/apis/qstash-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/qstash-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/qstash-rest-api/revisions/0c3b83ef4770?raw)