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.
  • 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 three 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 of your dashboard.

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

3. From an alert email notification. If you’ve received an error email, you can access your Task history from there as well.

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 adjust your notification preferences by going to the Email Notifications section of your account settings.

Once you’ve gotten to your Task History page, you can drill down more specifically to only look at Tasks of a certain Zap, certain task statuses, or 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 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.

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 Download [x].

Click on the Download [x] button to download the Task history for selected tasks

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: 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: 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.

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

In addition to a Status, some Zaps may also show a Status Reason in your Task history.

Review your Status and Status Reason

Zaps with a status of Stopped, Waiting, and Holding will include a Status Reason, which can give you additional insight into what may be affecting your Zap. You can learn more about what each reason means 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.

click on the data in option to see what data was sent to your action
  • 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 Task History page as well. Here, you can filter tasks by status, Zap, or date, 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 want to replay to see details about it

Then, in the upper left, click Play [x].

Click the Play button to replay selected Tasks

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.

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 over 1,500 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, 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 1,500 apps.