Explore your task history and troubleshoot Zaps

By The Zapier Team

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.
  • Statuses show whether your Zap was successful, got stopped by a filter, hit an error, and more.
  • 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 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. Your task history gives you a place to see everything that’s been done by your Zap.

How to find and navigate your task history

There are two main ways to access your task history:

1. From your dashboard. You can review the history of your tasks for your entire Zapier account by going to the Task History page from the site navigation.

2. From the Zap editor. You can also get to the Task History page by clicking the Task History icon in the Zap editor.

Click on the Task History icon

Your Task History is separated into two tabs:

  • Usage: Here you can see the total number of tasks currently recorded for each of your Zaps.
  • Task Log: Here you can see each individual time a Zap has run, the status of that run, and the number of tasks used in that run.

On both tabs, you can filter tasks in the following ways:

  • By Zap: Show only the tasks for a specific Zap or for all Zaps.
  • By status: Show tasks that fall under a specific status. For example, show only tasks that have errors.
  • By date: Show only tasks from a specific time period. You can also use the prefilled dates like Current Billing.
  • By folder: Show only the tasks for Zaps in a specific folder.
  • By owner: Team and Company accounts have multiple members. You can filter by the owner of the Zap.
  • By app: Show only tasks for a specific app.
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 out why a specific task didn’t work the way you’d expect. Type the term or terms in the search bar on the Task History page.

On the Usage tab you can also generate a .csv file of your task history and export it to your email address for your records. Click the checkbox for an individual task or choose an option from the checkbox dropdown menu to bulk select tasks. Once you've selected the task or tasks you're interested in, click the Download button.

In the dialog box that opens, click Generate & Email CSV to send a CSV to your Zapier account’s email address. This may take a few minutes.

Interpreting your task history

Your Task History page shows you valuable information about what’s going on behind the scenes. Zap statuses specifically are able to give you some insight into what’s happening in your Zap.

Here are the different task history statuses and what they mean:

  • Success: The Zap ran as expected and is now complete.

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

  • Stopped/Errored or Stopped/Halted: This Zap was stopped because it ran into an error. If a Zap hits too many errors in a row, it will be automatically paused.

  • Waiting/Delayed or Waiting/Scheduled: The Zap is waiting to complete. Zaps that have a Delay step or are scheduled to Autoreplay will have this status.

  • Playing: The Zap is currently running.

  • Held: The Zap is being held for one of a few reasons.

  • Skipped: This is a very rare status, but can occur when a task has been delayed and the Zap was changed while it was delayed. The task(s) are unable to be completed.

You can read more about understanding task statuses in our help documentation.

You can also click an individual task history item to see more detail.

This page will show you each step of your Zap. Each step after the first—which is the trigger step—corresponds to a task. You can see the status of each individual task here, such as seeing if it ran successfully, if it hit an error, or if it didn't run at all.

For an even closer look, you can look at the Data In and Data Out tabs for each step.

  • Data In: This shows the data that was sent to the connected app for the given step.
  • Data Out: This shows the data that was received from the connected app for the given step.

You can learn more about what Data In and Data Out can tell you from our help documentation.

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

An X marking which step had an error in your Zap

If you click See more details or get help, you can then click Contact Support to submit a request for help with that particular error.

How to replay tasks

For users on any paid plan, unsuccessful tasks can be manually replayed from the Usage tab of the Task History page as well. Here, you can filter tasks and select tasks to replay individually or in bulk.

1. Individual: Select the checkboxes next to the tasks you want to replay.
2. Bulk: In the upper left, click the checkbox dropdown menu and select Select shown to select all the tasks on the page, or Select all (5,000 at a time) to select up to 5,000 tasks.

Select the tasks you'd like to replay, then click the Replay button.

If you're on a Professional plan or higher, you can use Autoreplay. If Autoreplay is enabled, Zapier will attempt to retry any tasks that fail due to temporary errors or downtime. Autoreplay will retry the action again immediately, and then a few more times if there is still an issue. Click the toggle next to Autoreplay to turn this feature on.

You can learn more about how Autoreplay works in our help documentation.

Beyond task history: Where to get more help

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

Sometimes, though, you may need help getting 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!

Workflow

Take the Work out of Workflow

Zapier is the easiest way to automate powerful workflows with more than 2,000 apps.