---
title: "Create a cron job"
method: POST
path: "/api/jobs"
tags: ["Jobs"]
---

# Create a cron job

`POST /api/jobs`

## Request

- Base URL: `https://api.cron.cool`
- URL: `https://api.cron.cool/api/jobs`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Requires the `jobs:write` scope.

## Request body

- object
  - `name` string
  - `expression` string, required: EventBridge Scheduler schedule expression
  - `type` string
  - `url` string
  - `httpMethod` string
  - `contentType` string
  - `input` object

## Response `200`

The created job

## Other responses

- `403`: API key is missing the `jobs:write` scope

---

[API](https://skmtc.dev/cron-cool/apis/croncool-api.md) · [All operations](https://skmtc.dev/cron-cool/apis/croncool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cron-cool/apis/croncool-api/revisions/316196bd734c?raw)