Troubleshooting Your Zaps#

There's a wide range of reasons that a Zap can come back with an error. We do our best to provide actionable error messages, but sometimes there's too many potential problems or an app's error messages are vague, leaving you to wonder what went wrong. Here's some steps you can take to get to the bottom of the problem:

Check Your Error Message#

We have a guide on common error messages here.

Check Your Task History#

Your task history is a log of all the tasks your Zap has attempted on your behalf, you can access it from this link or from your dashboard. While the task history won't show a record of tests made when configuring your Zap, or errors in connecting to your trigger, it's invaluable to identifying errors when your Zap tried to complete its action.

Two Task History Items

You can click on the "Data In" and "Data Out" buttons for both your Trigger and Action apps to see what data we received and sent on.

See your tasks Data

For more information on using the Task History to debug trouble with your Zap, please see our Task History Guide here.

Check Your Zap#

Many errors can be corrected with just a small change to the configuration of the Zap, especially the Action template. We go over some common scenarios here, but here's some things to look out for in general:

  • Are your filters going to filter too much, or not enough? Reference this guide for more details on filters.
  • When mapping fields for the action, have you used the + button to include data from your trigger? Whatever you manually type in will be sent through every time your Zap triggers.
  • When mapping fields for the action, are all the required fields filled in and are you using fields that will have data in them when your Zap triggers?
  • If you're using the "Use a Custom Value" option in a dropdown, is that sending data that the action will understand?

Check Your Accounts#

Sometimes your Zap is working successfully, but it may be creating data in a place you weren't originally expecting. Especially if you're creating something that belongs under another object(like how a Task may belong to a specific Project), check your Zap to make sure the destination you've chosen in your Zap matches where you're looking for that data in that app.

Check the Docs#

Some errors are a result of oddities in how a particular app behaves. We do our best to document those in our Service Documentation, so check that out for the app involved to make sure there's not an easy fix waiting for you!

Common Problems#

A Required field is empty#

When mapping action fields, you'll see the fields that the action app is telling Zapier are required to perform that action.

Required Fields

Make sure that the fields you choose to include from the trigger app will always have data in them. If they are ever empty, then the Zap will very likely create an error.

If you're okay with trigger data not always being included, there are a couple potential workarounds:

NOTE: These workarounds may not apply universally: some apps have more strict requirements about the values that can be used, as well as varying degrees of acceptance for duplication. Also, if there is more than one required field where this is an issue, the 2nd workaround will require several Zaps to account for all the potential outcomes. We don't recommend that 2nd workaround if there's more than one required field with a risk of empty data in the trigger.

Dropdown choices are empty#

Dropdowns show possible values to be used within fields.

Often the choices are dependent on some specific criteria, like the value of a previous dropdown. Sometimes choices are dependent on the account you've connected because choices may be dependent on your account's permissions.

If you're seeing empty choices, make sure the account you've connected has the necessary permissions to show all of the desired choices, and make sure that any criteria you have set up in your Zap that may be filtering out choices is set up appropriately.

For example on the screenshot below this "list" dropdown doesn't have any options, as I don't yet have any lists on that particular Trello board:

If I add a list to that board on my Trello account, that will then appear in that dropdown on my Zap template like this:

Filters are not working as intended#

If you use any filters in your Zap, especially custom filters, make sure that you understand the logic those filters are using. There are two easy ways to check on your filters:

  • Your test will show if your filters would stop your sample: LINK
  • Your task history will show tasks stopped by your filters in gray: LINK

In both instances, you should see a reference to which filter(s) is stopping that task from proceeding. Here are a couple other common issues people run into with filters:

  • If you have multiple filters and want them all to apply to each task, make sure to force them to use AND logic. You can create AND filters using the "Add AND Filter" button under each custom filter.
  • If you use the "(text) Exactly matches" condition, sometimes that will filter more than you expect. Unless there are multiple values coming through for the field your filter is monitoring, you should use "(text) contains" instead to avoid that problem.
  • If you use AND filters and they are both looking at the same field, it's more likely that your Zap will be filtering every triggered task. Unless you are absolutely sure there is more than one value you need to filter for that field, multiple AND filters for the same field should be avoided.
  • The value portion of the filter has a 255 character limit.

Times are incorrect for events#

If your Zap is creating an event, or taking a date from an event to send somewhere else, here's some common fixes that can avoid errors:

  • Make sure you have your time zone settings set in Zapier. It's one of the User Settings you can adjust at this link. If your time zone isn't set, then you may see events created by your Zaps that are off by a consistent number of hours.
  • If you are using Google Calendar and you use DD/MM/YYYY as your date format, you'll have to make an adjustment in your Zap. Google Calendar only accepts MM/DD/YYYY values through their API, so in order to create events on the right date, your Zap will need dates in the MM/DD/YYYY format.
  • If you need to create events that are intentionally offset by a certain time or date (e.g. create an event for a date + 7 days), you can use our datetime modifiers to accomplish that:

Using Custom Values in Dropdowns#

Sometimes you may find you don't want to use a fixed values in a drop down but using a custom value can cause errors if it doesn't match up with what your app is expecting. To avoid that please follow our guide here.

What Does It Mean If Your App Is Tagged "Deprecated"#

If you notice the app on your Zap is tagged "Deprecated" that means that the version you are using has been deprecated and a newer version of the app is available.

What to Do with Your "Deprecated" App#

If your App has been deprecated you will need to switch to the new version as soon as possible. We will send you an email to let you know when the deprecated version will be removed so you know when that will happen.

If you don't get your Zap updated before the date we specified in the email we sent you, your Zap will turn off automatically and we will send you another email to let you know.

To switch to the new version, simply select the app version on your Zap that does not specify "Deprecated". When you do this, your Zap will turn off. You will then need to reselect any options, remap any fields and retest your steps. Once you have done that, you can turn your Zap back on again.

Note, if you Zap uses a Delay step if you have any delayed tasks waiting those will not be able to run once you have switched to the new version. You'll want to either allow those to run before switching or plan to re-trigger them once you have migrated!