---
title: "Create Schedule"
method: POST
path: "/schedules"
tags: ["Schedules"]
---

# Create Schedule

`POST /schedules`

## Request body

- ScheduleCreate
  - `name` string, required
  - `cron_expr` string, required
  - `endpoint` string, required
  - `method` string
  - `description` string, nullable
  - `payload` object, nullable
  - `timezone` string
  - `timeout_seconds` integer
  - `max_retries` integer
  - `retry_delay_seconds` integer

## Response `201`

Successful Response

- ScheduleResponse
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `method` string, required
  - `endpoint` string, required
  - `payload` object, nullable
  - `cron_expr` string, required
  - `timezone` string, required
  - `timeout_seconds` integer, required
  - `max_retries` integer, required
  - `retry_delay_seconds` integer, required
  - `enabled` boolean, required
  - `next_run_at` integer, nullable
  - `created_at` integer, nullable
  - `updated_at` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)