Skip to main content
POST
/
crons
/
{id}
/
trigger
Trigger cron
curl --request POST \
  --url https://api.example.com/crons/{id}/trigger
{
  "id": "<string>",
  "status_code": 123,
  "success": true,
  "response_time_ms": 123,
  "fired_at": "<string>"
}
Manually triggers the cron’s webhook without waiting for the next scheduled run. This does not affect the cron’s schedule — next_run_at remains unchanged.

​
Path parameters

​
id
string
required
The UUID of the cron to trigger.

​
Response

Returns the execution result. The webhook is fired regardless of whether the cron is paused.
​
status_code
integer
HTTP status code returned by the webhook endpoint.
​
success
boolean
true if the webhook returned a 2xx status code.
​
response_time_ms
integer
Execution time in milliseconds.
​
fired_at
string
ISO 8601 timestamp of when the webhook was fired.
curl -X POST https://app.cronapi.dev/api/v1/crons/a1b2c3d4-e5f6-7890-abcd-ef1234567890/trigger \
  -H "Authorization: Bearer your_api_key_here"
200
{
  "status_code": 200,
  "success": true,
  "response_time_ms": 145,
  "fired_at": "2026-04-15T14:31:30.123Z"
}
The execution is logged as a run and the cron’s last_run_at is updated.