Work with agents

Webhook events

Configure webhooks to receive notifications when agent runs are created, completed, or interrupted.

Run events

Event typeDescription
run.createdSent when a Run is created and begins executing.
run.completedSent when a Run finishes with a status of completed or error.
run.interruptedSent when a Run pauses and is waiting for input. See Take action.

Sample payloads

1{
2  "object": "event",
3  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
4  "type": "run.created",
5  "data": {
6    "object": {
7      "object": "run",
8      "id": "c1d2e3f4-5678-90ab-cdef-1234567890ab",
9      "created_at": "2026-01-15T12:00:00.000Z",
10      "updated_at": "2026-01-15T12:00:00.000Z",
11      "status": "running",
12      "started_at": "2026-01-15T12:00:01.000Z",
13      "ended_at": null,
14      "steps": [],
15      "interrupts": []
16    }
17  },
18  "created_at": "2026-01-15T12:00:01.000Z"
19}
Get a demo
Contact your account manager or contact sales to inquire about access.