API ReferenceTask Runs
Create a task run
POST /tasks
Create a task run
Create a task.
https://api.edgecron.com/v1/tasks
Authentication required
Send `X-Key-ID`, `X-Timestamp`, and `X-Signature` with every request. The signature is lowercase hex HMAC-SHA256 over `timestamp + "\n" + payload`.
Parameters
This endpoint does not define path or query parameters.
Request body
| Parameters | Type | Required | Description |
|---|---|---|---|
endpoint_id | integer (int64) | Yes | Target webhook endpoint ID |
payload | string | No | JSON payload to deliver |
run_at | integer (int64) | No | Unix timestamp, 0 = execute immediately |
{
"endpoint_id": 101,
"payload": {
"invoice_id": "inv_123",
"status": "paid"
},
"run_at": 1772534400
}Response
All successful responses use the EdgeCron API envelope.
{
"code": 0,
"message": "success",
"request_id": "req_abc123",
"data": {
"id": 101,
"app_id": "app_123",
"schedule_id": 101,
"event_id": 101,
"endpoint_id": 101,
"task_type": "schedule",
"payload": {},
"status": "pending",
"run_at": 1772534400,
"created_at": "2026-07-01T12:00:00Z"
}
}Schema
| Parameters | Type | Required | Description |
|---|---|---|---|
id | integer | No | Resource identifier. |
app_id | string | No | Application identifier. |
schedule_id | integer | No | - |
event_id | integer | No | - |
endpoint_id | integer | No | - |
task_type | schedule / event / manual | No | Allowed: schedule, event, manual. |
payload | object | No | JSON payload forwarded to the target endpoint. |
status | pending / running / success / failed / canceled | No | Allowed: pending, running, success, failed, canceled. |
run_at | string (date-time) | No | - |
created_at | string (date-time) | No | Creation timestamp. |