Explore Your Task History and Troubleshoot Zaps

By Hannah Rochau

You are reading: Chapter 7 of 12

Key Points

  • Your Task History is a log of everything that Zapier tried to automate on your behalf.
  • Status Codes show whether your Zap was successful, got stopped by a Filter, or hit an error.
  • Searching Your Task History helps you track down specifics using the info in your tasks.
  • Users on paid plans can Replay Tasks that run into errors.

When Zapier’s running happily in the background, you should see that reflected in the records automagically created or updated in your apps. Once in awhile, though, something might go wrong and you’ll need more information–or maybe you just want to check that your Zap is running correctly. Task History gives you a place to see everything that’s been done by your Zap, offering an at-a-glance snapshot of the Tasks taken by your Zap.

Your task history

How to Find and Navigate Your Task History

There are three main ways to access your Task History:

1. You can get to the Task History for your entire Zapier account by clicking on the dropdown button next to your user profile at the top righthand corner of the page, like this:

how to find your task history

2. You can also get to Task History for an individual Zap from your "My Zaps" page

3. If you’ve received an error email, you can access your Task History from there as well –– more on that in a bit.

Once you’ve gotten to your Task History page, you can drill down more specifically to only look at Tasks of a certain Zap, look at only certain task statuses, or look at Tasks that fall under a certain date range:

task history navigation bar

You can also search all filtered tasks for specific content. This is especially helpful if you’re trying to troubleshoot or figure why a specific Task didn’t work the way you’d expect. Type the term or terms in the search bar, like this:

search your task history to find relevant items

For users on paid plans, unsuccessful tasks can be replayed from Task History as well:

click on a task to see details about it

Keep in mind that the replay function will respect the existing configuration of your Zap, but will not fetch the most recent trigger data if your records have changed.

You can also generate a .csv file of your task history and export it to your email address for your records:

download a csv of your tasks

Interpreting Your Task History

Great, so you’ve found a list of Tasks! Now what? Task History shows you valuable information about what’s going on behind the scenes. Zap statuses specifically are able to give you some insight about what’s happening in your Zap. Here are the different Task History statuses and what they mean:

  • Success: The Zap performed this Task as expected.

  • Error: This Task ran into some error running; click it for more details. If a Zap hits too many errors in a row it will be automatically paused.

  • Filtered: This Task was stopped because your Zap filters prevented it from continuing.

  • Halted: This Task was stopped on purpose by Zapier. Unlike errors, halted Tasks do not automatically pause your Zap. For example, MailChimp rejects duplicate email subscribers to an email list. Instead of logging this as an error, Zapier will mark it halted. Also, when a search step in a Multi-Step Zap does not find a result, that step will be often be halted. These two cases account for 90% of halted Tasks.

  • Scheduled: This status is only shown on Tasks that are waiting to be autoreplayed.

  • Pending: Sometimes Zapier needs extra time to perform a Task. It will be marked pending if this is the case. However, if you see tasks that are stuck in pending for more than a few minutes, they’re going to be stuck in a bit of a Zapier limbo. We recommend reaching out to Zapier support if you get Tasks caught in a pending state.

  • Delayed: Used by the Delay by Zapier actions waiting to run.

From the list of Tasks shown from your selected filters, you can click on an individual Task to see more detail.

The individual Task’s page will show you what steps of your Zap ran successfully, were filtered, were halted, were delayed, or hit an error. For an even closer look, you can look at the “data in” and “data out” tabs for each step.

click on the data in option to see what data was sent to your action

If the Task you’re looking at hit an error, you can see more information about that from this page too. The errored step will be marked in red, and a red bar with more information at the bottom will give some additional information about the error that caused your Task to fail.

That page will also have your Task’s ID:

how to find your task id

While that information probably isn’t especially useful to your day-to-day Zapier use, it’s super-handy to pass along if you ever need to contact support.

Beyond Task History: Identifying and Addressing Errors

So what’s the point of all this history being accessible? Why should it matter to you?

In short, Zapier is a pretty complex machine: We work with over 500 different apps and our workflows are infinitely customizable. In the perfect world, your Zaps would run flawlessly without exception. However, sometimes things break or don’t work quite the way we’d expect. When those errors crop up, Task History can help you get things running smoothly again.

Depending on your email settings, Zapier will send you an automated alert on either individual or repeated errors in your zap. From that email, you can see the error message and also navigate directly to your Task History for more information.

You can use this information to troubleshoot your Zaps or help the Zapier support team get to the bottom of any errors faster. For more troubleshooting advice for your Zaps, see our help documentation or feel free to reach out to us. We're here to help!


Take the Work out of Workflow

Zapier is the easiest way to automate powerful workflows with more than 1,500 apps.