Twilio taskrouter webhook events
Twilio documents 39 TaskRouter events in Event Streams. Its pages show one generic example body under each event, with name: ReservationCreated, so among the task, reservation, queue, worker and workflow events only com.twilio.taskrouter.reservation.created has a sample here. 2 have sample payloads.
Twilio has two systems that send you webhooks. Messaging, Voice and other products call a URL you set on a number or resource, with form parameters and no event type field. Event Streams sends JSON CloudEvents with a type. The events list names Event Streams types and Conversations (classic) actions, because a status callback has no event name to list. SendGrid's email events are separate: see SendGrid webhooks.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
com.twilio.apiusage.taskrouter.ratelimits
documented from Twilio docs (example)
com.twilio.apiusage.taskrouter.ratelimits TaskRouter reports a rate limit result
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
{
"specversion": "1.0",
"type": "com.twilio.apiusage.taskrouter.ratelimits",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/Twilio.RateLimitResults/2",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.apiusage.taskrouter.ratelimits |
Full schema: 17 fields.
From Twilio docs
-
Content type
application/json
com.twilio.taskrouter.task.created
documented No payload yet
com.twilio.taskrouter.task.created Task is created
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.updated
documented No payload yet
com.twilio.taskrouter.task.updated Task is updated
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.canceled
documented No payload yet
com.twilio.taskrouter.task.canceled Task is canceled
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.completed
documented No payload yet
com.twilio.taskrouter.task.completed Task is completed
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.wrapup
documented No payload yet
com.twilio.taskrouter.task.wrapup Task moves into wrap-up
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.deleted
documented No payload yet
com.twilio.taskrouter.task.deleted Task is deleted
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.system-deleted
documented No payload yet
com.twilio.taskrouter.task.system-deleted Task reaches its TTL and the system deletes it
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.transfer-initiated
documented No payload yet
com.twilio.taskrouter.task.transfer-initiated Task transfer starts
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.transfer-completed
documented No payload yet
com.twilio.taskrouter.task.transfer-completed Task transfer completes
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.transfer-canceled
documented No payload yet
com.twilio.taskrouter.task.transfer-canceled Task transfer is canceled
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.transfer-failed
documented No payload yet
com.twilio.taskrouter.task.transfer-failed Task transfer fails
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task.transfer-attempt-failed
documented No payload yet
com.twilio.taskrouter.task.transfer-attempt-failed One attempt to transfer a task fails
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.created
documented from Twilio docs (example)
com.twilio.taskrouter.reservation.created Task is reserved for a worker
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
{
"specversion": "1.0",
"type": "com.twilio.taskrouter.reservation.created",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/TaskRouter.WDSEvent/4",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.taskrouter.reservation.created |
Full schema: 103 fields.
From Twilio docs
-
Content type
application/json
com.twilio.taskrouter.reservation.accepted
documented No payload yet
com.twilio.taskrouter.reservation.accepted Worker accepts a reservation
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.rejected
documented No payload yet
com.twilio.taskrouter.reservation.rejected Worker rejects a reservation
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.canceled
documented No payload yet
com.twilio.taskrouter.reservation.canceled Reservation is canceled
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.completed
documented No payload yet
com.twilio.taskrouter.reservation.completed Reservation is completed
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.failed
documented No payload yet
com.twilio.taskrouter.reservation.failed A reservation fails
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.rescinded
documented No payload yet
com.twilio.taskrouter.reservation.rescinded Another worker accepts the task, so this reservation is withdrawn
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.timeout
documented No payload yet
com.twilio.taskrouter.reservation.timeout Reservation times out
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.reservation.wrapup
documented No payload yet
com.twilio.taskrouter.reservation.wrapup Reservation moves into wrap-up
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task-queue.created
documented No payload yet
com.twilio.taskrouter.task-queue.created Task queue is created
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task-queue.deleted
documented No payload yet
com.twilio.taskrouter.task-queue.deleted Task queue is deleted
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task-queue.entered
documented No payload yet
com.twilio.taskrouter.task-queue.entered Task enters a task queue
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task-queue.moved
documented No payload yet
com.twilio.taskrouter.task-queue.moved Task moves between task queues
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task-queue.timeout
documented No payload yet
com.twilio.taskrouter.task-queue.timeout Routing step times out and the task leaves its queue
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.task-queue.expression.updated
documented No payload yet
com.twilio.taskrouter.task-queue.expression.updated Task queue's worker expression changes
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.worker.created
documented No payload yet
com.twilio.taskrouter.worker.created Worker is created
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.worker.deleted
documented No payload yet
com.twilio.taskrouter.worker.deleted Worker is deleted
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.worker.activity.update
documented No payload yet
com.twilio.taskrouter.worker.activity.update Worker's activity changes
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.worker.attributes.update
documented No payload yet
com.twilio.taskrouter.worker.attributes.update Worker's attributes change
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.worker.capacity.update
documented No payload yet
com.twilio.taskrouter.worker.capacity.update Worker's capacity changes
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.worker.channel.availability.update
documented No payload yet
com.twilio.taskrouter.worker.channel.availability.update Worker's channel availability changes
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.workflow.entered
documented No payload yet
com.twilio.taskrouter.workflow.entered Task enters a workflow
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.workflow.rejected
documented No payload yet
com.twilio.taskrouter.workflow.rejected Workflow rejects a task
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.workflow.skipped
documented No payload yet
com.twilio.taskrouter.workflow.skipped Task skips out of a workflow and leaves the workspace
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.workflow.target-matched
documented No payload yet
com.twilio.taskrouter.workflow.target-matched Task matches a workflow target
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
com.twilio.taskrouter.workflow.timeout
documented No payload yet
com.twilio.taskrouter.workflow.timeout Task reaches the end of a workflow unaccepted and is removed
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource taskrouter
No payload yet.
Route Twilio events by type.
Event Gateway receives every Twilio delivery and filters and routes it by event type, so each service gets only the events it handles.