# 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. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/twilio/mcp-events).

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](/webhooks/twilio/events) 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](/webhooks/sendgrid/guide-duplicates-ordering-retries-timeouts).

Agent skill: `npx skills add hookdeck/webhook-skills --skill twilio-webhooks` ([details](https://hookdeck.com/webhooks/twilio/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Twilio's official docs](https://www.twilio.com/docs/events/webhook-quickstart).

[Overview](https://hookdeck.com/webhooks/twilio) · [Webhook events (199)](https://hookdeck.com/webhooks/twilio/events) · [MCP events](https://hookdeck.com/webhooks/twilio/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/twilio/verify) · [Production guide](https://hookdeck.com/webhooks/twilio/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/twilio/skill)

## com.twilio.apiusage.taskrouter.ratelimits

Confidence: documented · Schema: from Twilio docs (example)

TaskRouter reports a rate limit result

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

```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": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-apiusage-taskrouter-ratelimits.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `NO00000000000000000000000001` |
| `type` | string | `com.twilio.apiusage.taskrouter.ratelimits` |

From Twilio docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-apiusage-taskrouter-ratelimits.json)

## com.twilio.taskrouter.task.created

Confidence: documented · Schema: No payload yet

Task is created

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-created.json)

## com.twilio.taskrouter.task.updated

Confidence: documented · Schema: No payload yet

Task is updated

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-updated.json)

## com.twilio.taskrouter.task.canceled

Confidence: documented · Schema: No payload yet

Task is canceled

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-canceled.json)

## com.twilio.taskrouter.task.completed

Confidence: documented · Schema: No payload yet

Task is completed

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-completed.json)

## com.twilio.taskrouter.task.wrapup

Confidence: documented · Schema: No payload yet

Task moves into wrap-up

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-wrapup.json)

## com.twilio.taskrouter.task.deleted

Confidence: documented · Schema: No payload yet

Task is deleted

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-deleted.json)

## com.twilio.taskrouter.task.system-deleted

Confidence: documented · Schema: 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 · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-system-deleted.json)

## com.twilio.taskrouter.task.transfer-initiated

Confidence: documented · Schema: No payload yet

Task transfer starts

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-transfer-initiated.json)

## com.twilio.taskrouter.task.transfer-completed

Confidence: documented · Schema: No payload yet

Task transfer completes

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-transfer-completed.json)

## com.twilio.taskrouter.task.transfer-canceled

Confidence: documented · Schema: No payload yet

Task transfer is canceled

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-transfer-canceled.json)

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

Confidence: documented · Schema: No payload yet

Task transfer fails

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-transfer-failed.json)

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

Confidence: documented · Schema: No payload yet

One attempt to transfer a task fails

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-transfer-attempt-failed.json)

## com.twilio.taskrouter.reservation.created

Confidence: documented · Schema: from Twilio docs (example)

Task is reserved for a worker

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

```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": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `NO00000000000000000000000001` |
| `type` | string | `com.twilio.taskrouter.reservation.created` |

From Twilio docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-created.json)

## com.twilio.taskrouter.reservation.accepted

Confidence: documented · Schema: No payload yet

Worker accepts a reservation

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-accepted.json)

## com.twilio.taskrouter.reservation.rejected

Confidence: documented · Schema: No payload yet

Worker rejects a reservation

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-rejected.json)

## com.twilio.taskrouter.reservation.canceled

Confidence: documented · Schema: No payload yet

Reservation is canceled

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-canceled.json)

## com.twilio.taskrouter.reservation.completed

Confidence: documented · Schema: No payload yet

Reservation is completed

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-completed.json)

## com.twilio.taskrouter.reservation.failed

Confidence: documented · Schema: No payload yet

A reservation fails

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-failed.json)

## com.twilio.taskrouter.reservation.rescinded

Confidence: documented · Schema: 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 · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-rescinded.json)

## com.twilio.taskrouter.reservation.timeout

Confidence: documented · Schema: No payload yet

Reservation times out

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-timeout.json)

## com.twilio.taskrouter.reservation.wrapup

Confidence: documented · Schema: No payload yet

Reservation moves into wrap-up

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-reservation-wrapup.json)

## com.twilio.taskrouter.task-queue.created

Confidence: documented · Schema: No payload yet

Task queue is created

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-queue-created.json)

## com.twilio.taskrouter.task-queue.deleted

Confidence: documented · Schema: No payload yet

Task queue is deleted

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-queue-deleted.json)

## com.twilio.taskrouter.task-queue.entered

Confidence: documented · Schema: No payload yet

Task enters a task queue

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-queue-entered.json)

## com.twilio.taskrouter.task-queue.moved

Confidence: documented · Schema: No payload yet

Task moves between task queues

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-queue-moved.json)

## com.twilio.taskrouter.task-queue.timeout

Confidence: documented · Schema: 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 · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-queue-timeout.json)

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

Confidence: documented · Schema: No payload yet

Task queue's worker expression changes

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-task-queue-expression-updated.json)

## com.twilio.taskrouter.worker.created

Confidence: documented · Schema: No payload yet

Worker is created

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-worker-created.json)

## com.twilio.taskrouter.worker.deleted

Confidence: documented · Schema: No payload yet

Worker is deleted

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-worker-deleted.json)

## com.twilio.taskrouter.worker.activity.update

Confidence: documented · Schema: No payload yet

Worker's activity changes

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-worker-activity-update.json)

## com.twilio.taskrouter.worker.attributes.update

Confidence: documented · Schema: No payload yet

Worker's attributes change

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-worker-attributes-update.json)

## com.twilio.taskrouter.worker.capacity.update

Confidence: documented · Schema: No payload yet

Worker's capacity changes

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-worker-capacity-update.json)

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

Confidence: documented · Schema: No payload yet

Worker's channel availability changes

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-worker-channel-availability-update.json)

## com.twilio.taskrouter.workflow.entered

Confidence: documented · Schema: No payload yet

Task enters a workflow

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-workflow-entered.json)

## com.twilio.taskrouter.workflow.rejected

Confidence: documented · Schema: No payload yet

Workflow rejects a task

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-workflow-rejected.json)

## com.twilio.taskrouter.workflow.skipped

Confidence: documented · Schema: 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 · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-workflow-skipped.json)

## com.twilio.taskrouter.workflow.target-matched

Confidence: documented · Schema: No payload yet

Task matches a workflow target

Identified by: type in each CloudEvent on Event Streams; none on classic callbacks · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-workflow-target-matched.json)

## com.twilio.taskrouter.workflow.timeout

Confidence: documented · Schema: 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 · Object: `taskrouter`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/twilio/events/com-twilio-taskrouter-workflow-timeout.json)

---

Not affiliated with Twilio. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/twilio.json) · [Report a correction](https://hookdeck.com/contact)
