Build reusable Sub-Zaps

With Sub-Zap by Zapier, you can create a set of actions to re-use in multiple Zaps.

actionEdit icon Example

If you have multiple Zaps where you want to use an email address to:

  • look up a customer in Google Sheets
  • find a contact in Pipedrive

you can use a Sub-Zap by Zapier step to create those actions. Instead of adding those actions steps to each Zap, you can use a single Call a Sub-Zap action to perform those actions.

miscEye icon Note

Sub-Zaps by Zapier is a beta feature.

1. Create a Sub-Zap

Sub-Zaps are created the same way that Zaps are created.

  • Create a new Zap.
  • In the Zap editor, click to open the Trigger step.
  • In the Choose app & event section, search for and select Sub-Zap by Zapier.
  • Click the Event dropdown menu and select the Start a Sub-Zap trigger.
  • In the Set up trigger section, enter one or more inputs in the Input/Argument List field.
  • Click Continue.
miscEye icon Note
  • Inputs are the names of fields in your Zap that send the Sub-Zap data. Add any inputs that you’ll need to use in your Sub-Zap actions. If you want an input field to be required, add "required" anywhere in the name of the input.
  • If you want to use real data in your Sub-Zap, you must create and test a Call a Sub-Zap action before testing the Sub-Zap trigger. Otherwise, default sample data is provided.

2. Add a Call a Sub-Zap action to your Zap

  • In your Zap, click the Action step or click the plus + icon to add an action to your Zap.
  • Search for and select Sub-Zap by Zapier.
  • Click the Event dropdown menu and select the Call a Sub-Zap action.
  • In the Set up action section, select your sub-Zap from the Select Your Sub-Zap dropdown menu.
  • The input fields you created in your sub-Zap will appear. Set up the data that you want to send over to your Sub-Zap.
  • Click Continue.
  • In the Test action section, click Test & Review.

3. Test your Sub-Zap trigger

  • In your Sub-Zap, select the Test your trigger section.
  • Click Test & Review.

4. Add actions to your Sub-Zap

You can add as many actions to your Sub-Zap as you want. All Sub-Zap actions will run each time the Sub-Zap is called by a Zap.

The Sub-Zap must end with a Return From a Sub-Zap action. This action collects the data to send back to your Zap.

  • In your Sub-Zap, click the Action step or click the plus + icon to add an action to your Zap.
  • Search for and select Sub-Zap by Zapier.
  • Click the Event dropdown menu and select the Return From a Sub-Zap action.
  • In the Set up action section, set up your outputs in the Output/Return Values field:
    • In the field on the left, enter the output name.
    • In the field on the right, click the field and select a field from a preceding action with the data you want to send to your Zap.
    • Repeat this step for each output you want to send to your Zap.
  • Click Continue.
  • In the Test action section, click Test & Review.
miscEye icon Note

If you add a Return From a Sub-Zap action to your Zap, it will return this error: "Did you fork or replay this step? We expected callbackUrl to be stored!"
To prevent this error, only add a Return From a Sub-Zap action in your Sub-Zap.

5. Frequently asked questions

How many tasks does Sub-Zap by Zapier use?

Each time a Zap calls a Sub-Zap:

  • 2 tasks are used by the Sub-Zap by Zapier app.
  • Each action step within the Sub-Zap uses 1 task.

In the example above, 4 tasks are used by the Sub-Zap:

  • The Start a Sub-Zap trigger uses no tasks.
  • The Call a Sub-Zap action uses 1 task.
  • The Google Sheets action uses 1 task.
  • The Pipedrive action uses 1 task.
  • The Return From a Sub-Zap action uses 1 task.

Why is my Sub-Zap stuck in a Waiting status?

If you see a Sub-Zap with a Waiting status in your Zap run history, a Filter or Path action in the Sub-Zap prevented the Sub-Zap from continuing. Any Zaps associated with your Sub-Zap won't continue past the Return from a Sub-Zap action.

Learn more about Sub-Zap example workflows.

6. Limitations of Sub-Zap by Zapier

There are limitations on how Sub-Zaps work with other Zapier features.

Adding Sub-Zaps to Paths in a Zap:

  • If more than one path can run at the same time, only the first path that meets the conditions will run and other paths will error.
  • Sub-Zaps can only be called once per path.

Adding Paths actions within a Sub-Zap:

  • Paths can't be used in a Sub-Zap.

Adding Loop actions within a Sub-Zap:

  • Loop actions can't be used in a Sub-Zap.

For more details, read our Announcing Sub-Zap by Zapier post.

Was this article helpful?
1 out of 2 found this helpful