Help

View and manage your task history

tutorial
Last updated:

Zapier University

Task History

The Task History page is where you can see all the activity from your Zaps. It's a log of everything that Zapier has tried to automate on your behalf. You can see all the data that goes into and out of each step of your Zaps, which allows you to troubleshoot your Zaps when they don't work as expected.

Tip

Whenever your Zap successfully automates something, it's called a task. For example, if you have a two-step Zap with one action step to send out an SMS, the automated SMS sent out is your Task. Learn more about tasks in Zapier.


1. Understand task statuses

In Task History, you'll see the status of each time a Zap ran. There are five possible statuses:

  1. Success: the Zap ran and completed successfully.
  2. Filtered: the Zap had a filter that prevented it from continuing.
  3. Stopped: the Zap ran into an error while running. If a Zap hits too many errors in a row, it will be automatically paused.
  4. Waiting: the Zap is waiting to complete. Zaps that have a Delay step or are scheduled to Autoreplay will have this status.
  5. Playing: the Zap is currently running.
  6. Holding: the Zap is being held for one of a few reasons.

Different statuses can have different causes.

Reasons for status of "Stopped"

Task History items can have a status of Stopped for one of two reasons:

  • Errored: This Task ran into some error running. If a Zap hits too many Stopped Tasks in a row it will be automatically paused.
  • Halted: This Task was stopped on purpose by Zapier. Unlike Errored Tasks, many halted Tasks will not automatically pause your Zap.

Example

For example, MailChimp rejects duplicate email subscribers to an email list. Instead of logging this as an error, Zapier will mark it as Halted.

Reasons for status of "Waiting"

Task History items can have a status of Waiting for one of two reasons:

  • Delayed: If the Zap has a Delay step that is waiting to run, it will show as Delayed.
  • Scheduled: If the Zap is currently scheduled to be run again by Autoreplay, it will show up as Scheduled.

Reasons for status of "Holding"

Task History items can have a status of Holding for one of four reasons:

  • High Task Use: Too many (100+) of these Tasks were triggered at once. This "flood protection" prevents a significant number of tasks being performed by mistake. This helps keep your Task usage down and prevent tedious work correcting those unintended Tasks.
  • Reconnect {App Name}: The connection to one of the apps used in the Zap is broken. Reconnect the app from the Connected Accounts page first before replaying these Tasks.
  • Upgrade Needed: The account has passed its plan limit for Tasks or Zaps, or using a Premium App no longer supported by the plan. To replay these Tasks, an upgrade will be required first.
  • Payment Issue: The payment information on the account has expired. To replay these Tasks, updating this payment information will be required first.

Learn how to replay tasks that failed or were not successful.


2. View your task history

You can find Task History through a few different routes:

  • From your dashboard: You'll find Task History in the site navigation, or by selecting a Zap and choosing Task History, which will take you to a view of Task History filtered to this Zap's Tasks only.
  • From a Zap: Within the Zap editor, there's a link to Task History in the header that will take you to the Tasks for this Zap only.

3. Task History: List view

By default, the Task History list view shows every time a Zap runs, whether or not it was successful.

Heads Up

Task History will not show activity if your Zap checks for new data and does not find any.

In the list view, you can see the status of each time a Zap runs. Learn more about what each status means.

You can filter your Task History by a few dimensions:

  • By Zap: Show only the tasks for a specific Zap or for all Zaps.
  • By status: For example, show only Tasks that have errors.
  • By date: For example, show only Tasks from the last week.

You can also search through all tasks. The search bar searches through all data that was included in a given Task.

Example

Say you had a Zap that runs every time you receive a new email in Gmail. If you wanted to find the Task that ran for a given email, you could search by the sender's email address in the search field.


4. Task History: Detailed view

You can click any Task History item to open up that entry's detail view. On this screen, you can see each individual step of the Zap. Each step after the first—which is the trigger step—corresponds to a Task, and you can see the status of each individual Task, such as seeing if it ran successfully, if it hit an error, or if it didn't run at all.

Each step also shows the Data In and Data Out.

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

Note

Some apps return a copy of what was added, but not all apps or actions will have any data to send back to us here. In such cases, it's expected that the Data Out for an action will be blank.

If you ever notice that some of your Data In for an action in your Task History includes in curly brackets {{, it means that Zapier didn't get anything sent on for that field from your trigger.

In this example, the "Message Text" field is missing in the data going into the action.
Missing text going into action step

If this occurs, check the Data Out tab on your trigger step, which will display all the data Zapier was sent from the trigger. In this example, there was no "message text" sent from Slack. To resolve the error, the Zap template must be remapped and the "text" field chosen instead.

Data out from trigger step

First, re-test your trigger step in your Zap. This will ensure that your Zap has a recent sample. Then, delete the existing field in your Zap action step and search for and select the field again with the new sample data.


5. Delete tasks

You can delete your Tasks from Task History. This will remove them from your Task History, but will not remove them from your Task count. Learn more about how tasks are counted in Zapier.

  • Select the task(s) you want to delete.
  • At the top of the table, click Delete x.
  • Click Really delete? to confirm.

Delete tasks


6. Task history storage

Your Task History will store a maximum of three months rolling data of your tasks (but we can only guarantee a month rolling) or the last 10,000 tasks – whichever comes first.

If you need to keep longer term records of your task usage, we recommend regularly exporting your Task History as a back up.


Was this doc helpful?

Need More Help?

Zapier Support

Contact our world class support team and we’ll be happy to help you get up and running!
Contact Us

Hire an Expert

We have a directory of professionals across the globe who are ready to help.
Find a Zapier Expert