Skip to main content
POST
/
jobs
Create job
curl --request POST \
  --url https://api.example.com/jobs
{
  "at": "<string>",
  "url": "<string>",
  "name": "<string>",
  "method": "<string>",
  "headers": {},
  "body": {}
}

​
Request body

​
at
string
required
ISO 8601 timestamp of when to fire the webhook. Must be in the future.
​
url
string
required
Webhook URL to call.
​
name
string
Optional display name for the job.
​
method
string
default:"POST"
HTTP method: GET, POST, or DELETE.
​
headers
object
default:"{}"
Custom HTTP headers to include in the webhook request.
​
body
object
default:"{}"
JSON body to send with the webhook request.

​
Response

Returns the created job object with a 201 status code. The job starts with status: "pending". 
curl -X POST https://app.cronapi.dev/api/v1/jobs \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Send welcome email",
    "at": "2026-04-20T15:00:00.000Z",
    "url": "https://example.com/send-email",
    "method": "POST",
    "body": {"user_id": "usr_123"}
  }'
201
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "user_id": "d4e5f6a7-b890-1234-cdef-567890abcdef",
  "name": "Send welcome email",
  "at": "2026-04-20T15:00:00.000Z",
  "url": "https://example.com/send-email",
  "method": "POST",
  "headers": {},
  "body": {"user_id": "usr_123"},
  "status": "pending",
  "created_at": "2026-04-15T14:31:00.000Z"
}
400
{
  "error": "at must be in the future"
}