TriggerOnfleetReal-timeUpdated May 2026
When does Onfleet fire on failed deliveries?
Short answer: Drop the "Onfleet → Onfleet Task Failed" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Onfleet, not on a polling schedule.
Anatomy
What this trigger looks like in a workflow.
Drop it on the canvas. Configure a couple of fields. Publish.
In the builder
Trigger
Onfleet Task Failed
When the matching event happens
on task failednew task failedwhen task failedwhen a delivery task failswatch for task failed
What this trigger returns
for the curiousYou don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.
{"event": "taskFailed","address": "123 Main St, San Francisco","task_id": "task_123"}
Output shape
Fields available to downstream nodes.
Every field below can be referenced by name in any action or filter that comes after this trigger.
| Field | Type | Example |
|---|---|---|
| event | string | "taskFailed" |
| address | string | "123 Main St, San Francisco" |
| task_id | string | "task_123" |
Pairs with
Drop these actions after Onfleet Task Failed.
FAQ
Questions about Onfleet Task Failed.
How does the Onfleet Task Failed trigger work in Onfleet?
Fires when the driver marks a stop as unsuccessful (customer unavailable, refused, damaged). The high-signal CS hook — fires before the customer ever calls in to complain.
Is the Onfleet Task Failed trigger real-time?
Yes. Onfleet Task Failed uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Onfleet.
What data does Onfleet Task Failed return?
The full event payload from Onfleet. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.
Can I filter Onfleet Task Failed so only some events start a workflow?
Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.
Do I need Onfleet admin permissions to use Onfleet Task Failed?
For most Onfleet accounts a standard user can authorize the trigger. Some Onfleet plans require an admin to enable third-party webhooks. Check Onfleet's docs if the trigger fails to register.
More triggers
Other Onfleet triggers.
Trigger
Onfleet Task Completed
Fires when a driver completes a delivery. Payload includes proof-of-delivery (signature URL, photo URL), completion time, notes. For "delivered → notify customer, log to order record" cascading workflows.
TriggerOnfleet Task Created
Fires when a new delivery task is created. Useful for "log to delivery tracking spreadsheet" or "send pre-delivery SMS to recipient" workflows.
TriggerOnfleet Task Started
Fires when the driver picks up the next stop in their queue. For "driver is now en route → SMS the customer ETA" workflows.
TriggerOnfleet Worker Duty Change
Fires on shift start and end transitions. For capacity-planning workflows that track "who's actually rolling vs scheduled" or for "all drivers off-duty alert".
Build a workflow on this trigger.
One trigger. 2+ downstream actions. Zero glue.
