---
title: "Create Scheduled Job"
method: POST
path: "/v1/scheduled-jobs"
tags: ["ScheduledJobs"]
---

# Create Scheduled Job

`POST /v1/scheduled-jobs`

Create a new scheduled job

## Request body

- ScheduledJobCreate — Model for creating scheduled jobs (required fields enforced)
  - `job_name` string, required — Human-readable name for the scheduled job
  - `service_type` 'smartscraper' | 'searchscraper' | 'markdownify' | 'smartcrawler' | 'agenticscrapper' | 'site_monitor', required
  - `cron_expression` string, required — Standard 5-field cron expression (minute hour day month day_of_week) in UTC timezone. All times are interpreted as UTC (e.g., '0 9 * * 1' for 9 AM UTC every Monday)
  - `job_config` object, required — Service-specific configuration that matches the service's request schema
  - `is_active` boolean — Whether the job is active and should be scheduled
  - `webhook_url` string, nullable — Webhook URL to send the job result to

## Response `200`

Successful Response

- ScheduledJobResponse — Response model for scheduled job operations
  - `id` string, uuid, required
  - `user_id` string, uuid, required
  - `job_name` string, required
  - `service_type` 'smartscraper' | 'searchscraper' | 'markdownify' | 'smartcrawler' | 'agenticscrapper' | 'site_monitor', required
  - `cron_expression` string, required
  - `job_config` object, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `last_run_at` string, date-time, nullable
  - `next_run_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/scrapegraphai/apis/fastapi.md) · [All operations](https://skmtc.dev/scrapegraphai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapegraphai/fastapi/revisions/17bc5b01fe0c/schema)