---
title: "Create a new ingestion schedule"
method: POST
path: "/ingestion/schedules"
tags: ["ingestion"]
---

# Create a new ingestion schedule

`POST /ingestion/schedules`

## Request body

- CreateScheduleRequest
  - `config` object
  - `cron_expression` string
  - `enabled` boolean
  - `name` string
  - `plugin_id` string

## Response `201`

Created

- Schedule
  - `config` object
  - `created_at` string
  - `created_by` string
  - `cron_expression` string
  - `enabled` boolean
  - `id` string
  - `last_run_at` string
  - `last_run_status` string
  - `managed_by` string
  - `name` string
  - `next_run_at` string
  - `plugin_id` string
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2026-07-12** `32cf70022131` — 1 info
  - endpoint added
- **2025-06-02** `0c070796939d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/marmotdata/apis/marmot-api/changes/ingestion/schedules/post.md)

---

[API](https://skmtc.dev/marmotdata/apis/marmot-api.md) · [All operations](https://skmtc.dev/marmotdata/apis/marmot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marmotdata/apis/marmot-api/revisions/cadebfd78fef?raw)
