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

# Create Scheduled Job

`POST /v1/scheduled-jobs`

## Request

- Base URL: `https://api.scrapegraphai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.scrapegraphai.com/v1/scheduled-jobs`
- Auth: none declared

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/scrapegraphai-api.md) - [All operations](https://skmtc.dev/scrapegraphai/apis/scrapegraphai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrapegraphai/apis/scrapegraphai-api/revisions/a0e42195429f?raw)