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)

TaskRouter reports a rate limit result

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

twilio-com-twilio-apiusage-taskrouter-ratelimits.json
{
  "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

View as JSON

com.twilio.taskrouter.task.created

documented No payload yet

Task is created

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.updated

documented No payload yet

Task is updated

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.canceled

documented No payload yet

Task is canceled

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.completed

documented No payload yet

Task is completed

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.wrapup

documented No payload yet

Task moves into wrap-up

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.deleted

documented No payload yet

Task is deleted

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.system-deleted

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.taskrouter.task.transfer-initiated

documented No payload yet

Task transfer starts

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.transfer-completed

documented No payload yet

Task transfer completes

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.transfer-canceled

documented No payload yet

Task transfer is canceled

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.transfer-failed

documented No payload yet

Task transfer fails

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task.transfer-attempt-failed

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.created

documented from Twilio docs (example)

Task is reserved for a worker

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

twilio-com-twilio-taskrouter-reservation-created.json
{
  "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

View as JSON

com.twilio.taskrouter.reservation.accepted

documented No payload yet

Worker accepts a reservation

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.rejected

documented No payload yet

Worker rejects a reservation

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.canceled

documented No payload yet

Reservation is canceled

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.completed

documented No payload yet

Reservation is completed

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.failed

documented No payload yet

A reservation fails

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.rescinded

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.timeout

documented No payload yet

Reservation times out

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.reservation.wrapup

documented No payload yet

Reservation moves into wrap-up

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task-queue.created

documented No payload yet

Task queue is created

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task-queue.deleted

documented No payload yet

Task queue is deleted

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task-queue.entered

documented No payload yet

Task enters a task queue

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task-queue.moved

documented No payload yet

Task moves between task queues

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.task-queue.timeout

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.taskrouter.task-queue.expression.updated

documented No payload yet

Task queue's worker expression changes

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.worker.created

documented No payload yet

Worker is created

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.worker.deleted

documented No payload yet

Worker is deleted

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.worker.activity.update

documented No payload yet

Worker's activity changes

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.worker.attributes.update

documented No payload yet

Worker's attributes change

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.worker.capacity.update

documented No payload yet

Worker's capacity changes

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.worker.channel.availability.update

documented No payload yet

Worker's channel availability changes

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.workflow.entered

documented No payload yet

Task enters a workflow

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.workflow.rejected

documented No payload yet

Workflow rejects a task

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.workflow.skipped

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.taskrouter.workflow.target-matched

documented No payload yet

Task matches a workflow target

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource taskrouter

No payload yet.

Help fill this in → View as JSON

com.twilio.taskrouter.workflow.timeout

documented No payload yet

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.

Help fill this in → View as JSON

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.

Not affiliated with Twilio. Facts are compiled from public sources and linked inline.