Create and manage Zaps from OnceHub

The OnceHub connector for Zapier allows you to add Zaps directly from within your OnceHub account. This can be done using ready-made Zap templates, or by creating Zaps from scratch.

Adding a Zap from within OnceHub

  1. Log into your OnceHub account.
  2. Select your profile picture or initials in the top right-hand corner → Profile settings Zapier, and select the Add Zaps tab. Here, you can search for apps with Zap templates to connect with OnceHub. By default, the Popular Zaps category is selected, showing you the most popular Zaps used by OnceHub Users (Figure 1). Figure 1: The Add Zaps tab with the Popular Zaps category selected
  3. Filter the Zaps shown by selecting one or more apps in the Search area. The Zap templates are displayed below the Search area, listed by popularity by each selected app (see Figure 2).

    NoteTo find a specific app, you can type the app name in the Search bar. You can also sort the list of apps by popularity or alphabetically (see Figure 2).

    Figure 2: Selecting specific apps
  4. Click the Add Zap (Figure 3) button to add a Zap or to see a detailed description of the template. The Zap Editor will open in OnceHub, allowing you to customize the Zap (see Figure 4).Figure 3: The Add Zap button
  5. To add the template to your account click Create this Zap (see Figure 4). If you are not already logged in to Zapier or have not yet signed up for a Zapier account, you will be asked to log in or sign up at this stage.Figure 4: The Zap editor
  6. Select a OnceHub account. If you have already connected OnceHub with Zapier, simply select the account (see Figure 5). Make sure to test the connection by clicking the Test button (bottom of Figure 5).
    Figure 5: Selecting your OnceHub account
  7. If you have not connected an account, or want to connect a different account, click on the Connect an Account button to establish a new connection. You will be asked to provide your Zapier API Key and OnceHub Login ID in the Zapier authentication page.
  8. Click the link to open your OnceHub account in a new browser tab. Copy your API key and Login ID from the API Key tab in the OnceHub Zapier integration page (see Figure 6).

    Figure 6: Your API key and Login ID
  9. Once connected, click Save + Continue in the Zap Editor (see Figure 8).
  10. Test the OnceHub trigger. First, make sure you have an existing booking in your connected OnceHub account. If not, you can make a test booking by opening your Booking page in a new browser tab. Once you have at least one booking, click Fetch & Continue to test the trigger.
  11. Once the test is successful, click Continue

    NoteYou can add a Filter step to more accurately define when to trigger this Zap. For example, you can define a filter that states only specific booking events (e.g. “Scheduled” and “Rescheduled”) or specific Bookings pages will trigger the Zap. Learn more about adding a Filter step in Zapier

  12. Select an account for your Action app (see Figure 7). If you have already connected your account with Zapier, simply select the account. Make sure to test the connection by clicking the Test button. If you have not connected an account or want to connect a different account, click the Connect an Account button to establish a new connection. Once connected, click Save + Continue.Figure 7: Selecting an account for the Action app
  13. Set up the Action by filling in the fields (see Figure 8). Some fields require you to select values from the Action app, while other fields require you to use your own text and/or values from OnceHub fields. Click on a field’s drop-down to see which options are available. Use the Search bar at the top of the dropdown to search for a specific field. Values from OnceHub fields will be dynamically updated with the relevant booking data and customer data each time the Zap is triggered. In the example below, you have to choose a Google Sheet for Zapier to populate.
    Figure 8: Filling in the Action fields


  14. Test the Action step by following the instructions (see Figure 9). Once you are done testing, you can either add another step or click Publish to complete the Zap (see Figure 10).
     
     
    Figure 9: Testing the Action step
  15. Publish your Zap (see Figure 10).


Figure 10: Publishing your Zap

Congratulations! You are done. Your Zap is active and your workflow is automated. You can now close the Add Zap popup and return to browsing Zap templates in OnceHub.

NoteBy default, Zaps are only triggered from Booking pages you own. OnceHub administrators can be allowed to trigger Zaps from pages not under their ownership by enabling the Trigger Zaps from all Booking pages permission in the Administrator’s profile. Learn more about triggering Zaps from pages not under your ownership

If none of the ready-made Zaps suits your exact scenario, you can also create your own Zaps from scratch in Zapier with any of the 1,000+ apps connected. Learn how to do this by reading on in this article.

Managing Zaps from within OnceHub

The OnceHub connector for Zapier allows you to manage your OnceHub Zaps from within the comfort of your OnceHub account. OnceHub communicates with the Zapier API to retrieve a list of your OnceHub Zaps and their statuses.

Requirements:

To access your OnceHub Zaps from within OnceHub, you need a Zapier account.

Note

  • From within OnceHub, you can only access your OnceHub Zaps. Your non-OnceHub Zaps are not accessible via the Zapier API.
  • If you have a Zapier Team account, you will see Zaps from both your Zapier Personal account and team-shared Zaps in your OnceHub account.

Managing your OnceHub Zaps

To access your OnceHub Zaps:

  1. Select your profile picture or initials in the top right-hand corner → Profile settings Zapier.
  2. Select the Manage Zaps tab and click Connect (see Figure 1).
    Figure 1: The Manage Zaps tab
  3. In the Zapier login page, enter your Zapier email and password, and click Login.
  4. In the Zapier consent screen (see Figure 2), click Authorize to allow OnceHub to list your Zaps and their statuses. You will be redirected back to OnceHub.

    Figure 2: Zapier consent screen


  5. Once connected, you can view your OnceHub Zaps (see Figure 3).

    A Zap can be in one of the following states:

    On: The Zap is active and performing the action when triggered.

    Off: The Zap is complete but inactive. Turn on to use this Zap.

    Draft: The Zap is incomplete. Finish setup to activate this Zap.

    Figure 3: Your OnceHub Zaps

  6. To edit a Zap, click the pencil icon () to open the Zap Editor (see Figure 4).

In the Zap Editor, you can make any changes, including turning the Zap ON or OFF. Changes are automatically saved.

Note 
To delete a Zap, click on Dashboard within the Zap Editor (see Figure 4). Your Zapier account will open in a new browser tab. Locate the Zap and select Trash in the Zap's menu.

Figure 4: The Zap Editor from within OnceHub

     7. When finished, simply close the overlay popup.

Congratulations! You can now manage your OnceHub Zaps from within OnceHub.

Triggering Zaps from pages not under your ownership

By default, you can only trigger Zaps from Booking pages you own. If you're a OnceHub Administrator, you can remove this restriction for yourself and for other Administrators in the account. 

When Zap triggering from all Booking pages is enabled for an Administrator, the Administrator’s active Zaps will be triggered by booking events that occur on all Booking pages in the account effective immediately. 

To limit your Zaps to specific Booking pages, add a Filter step to your Zaps before enabling the permission to trigger Zaps from all Booking pages.

Important

Allowing an Administrator to trigger Zaps from pages owned by other Users means that you are giving this Administrator access to booking data and Customer data from all Booking pages in the account.

When Zap triggering from all pages is enabled, and other Users in the account are also connected to Zapier, there is a risk of duplicate or conflicting actions. For example, Customers may receive duplicate notifications. We recommend reviewing the Zaps of all connected Users before enabling this permission.

Requirements

To enable Zap triggering from all booking pages:

  • You must be a OnceHub Administrator. This permission is User-based and can only be granted to Administrators.
  • The Administrator for which the permission is enabled must have a Zapier API key.

Enabling Zap triggering from all pages

  1. Sign in to OnceHub.

  2. Select your profile picture or initials in the top right-hand corner → Profile settings  Permissions.

  3. Check the box Trigger Zaps for all booking pages and click Save. 

  4. In the Trigger Zaps from all booking pages pop-up, click Yes. Active Zaps will immediately apply to all booking pages in the account.

Creating Zaps using OnceHub as a Trigger

How to create a Zap using OnceHub as a Trigger

There are two ways to create a Zap using a OnceHub trigger:

  1. Use one of the Zap templates available to you within OnceHub

    OnceHub offers many Zap templates with more than 35+ applications, giving you access to pre-defined workflows for recommended use-cases. Our templates provide a guided setup experience with pre-filled options and fields, so you don't have to create Zaps from scratch in the Zap Editor.

    You can set up Zap templates directly from within your OnceHub account (see Figure 1). Simply search the specific apps with which we have templates, and click to add the template you require.

    Figure 1: Add Zaps within OnceHub

  2. Create a Zap from scratch in Zapier

    If none of the Zap templates suit your exact scenario, you can create your own Zaps from scratch in Zapier (see Figure 2). This allows you to connect OnceHub with more than 1000 apps.

    Figure 2: Click Create Zap to create a Zap from scratch

How to create a Zap from scratch in Zapier

Note
You can add a Filter step to more accurately define when to trigger this Zap. For example, you can define a Filter that allows the Zap to continue only when specific Bookings pages are used or when specific booking events occur (e.g. Scheduled and Rescheduled).

  1. Log in to Zapier, go to your Dashboard and click the MAKE A ZAP! button (see Figure 1).

    Figure 1: Click the Create Zap button

  2. Choose OnceHub as the trigger app. Type “oncehub” in the Choose a Trigger app field, and select OnceHub from the drop-down list.

  3. Select a OnceHub trigger. Learn more about the OnceHub triggers on Zapier

  4. Select a OnceHub account. If you have already connected your OnceHub account with Zapier, simply select the account. Make sure to test the connection by clicking the Test button.

  5. If you have not connected an account, or want to connect a different account, click on the Connect an Account button to establish a new connection. You will be asked to provide your Zapier API key and OnceHub login ID.

  6. Click the link to open your OnceHub account in a new browser tab and copy your API key and Login ID shown in the API key tab in the Zapier integration page in OnceHub (see Figure 2).

    Figure 2: Copy your API key and Login ID from OnceHub

  7. Once connected, click Continue.

  8. Test the OnceHub trigger. First, make sure you have an existing booking in your connected OnceHub account. If not, you can make a test booking by opening your Booking page in a new browser tab. Once you have at least one booking, click Fetch & Continue to test the trigger.

  9. Once the test is successful, click Continue.

  10. Choose an Action App with which to integrate OnceHub (see Figure 3).

    Figure 3: Choose an Action App

  11. Select the Action you want to occur when the Zap is triggered and click Continue (see Figure 4).

    Figure 4: Select the Action

  12. Select an account for your Action app. If you have already connected your account with Zapier, simply select the account as shown below. Make sure to always test the connection by clicking the Test button. If you have not connected an account or want to connect a different account, click the Connect an Account button to establish a new connection. Once connected, click Save + Continue.

  13. Set up the Action by filling in the fields. Some fields require you to select values from the Action app, while other fields require you to use your own text and/or values from OnceHub fields. Click on a field’s drop-down to see which options are available. Use the Search bar at the top of the dropdown to search for a specific field. Values from OnceHub fields will be dynamically updated with the relevant booking data and customer data each time the Zap is triggered. In the example below, OnceHub's Customer – Email field is used as the value for the Subscriber Email field in MailChimp, the Action app. Learn more about the OnceHub fields available in Zapier

  14. Test the Action step by following the instructions. Once you are done testing, you can either add another step or click Finish to complete the Zap.

  15. Turn on your Zap. If you haven’t named your Zap yet, you can name it on this screen (see Figure 5).

    Figure 5: Editing/publishing your Zap

  16. Congratulations! You are done. Your Zap is active and your workflow is automated.

    Note
    By default, Zaps are only triggered from Booking pages you own. OnceHub Administrators can be allowed to trigger Zaps from pages not under their ownership by enabling a permission in the Administrator’s profile. 

How to add a Filter step to a Zap in Zapier

A Filter is an optional step in a Zap that allows you to control when a Zap is triggered. You can define rules that state whether the Zap Action should be performed. For example, if you have multiple Booking pages, you can define a filter that states the Zap should only be triggered on specific Booking pages. Another option is to create filters that state the Zap should only be triggered upon specific booking events (e.g. Scheduled and Rescheduled).

In this article, we will review two examples in which a Filter can be useful: filtering by booking lifecycle phase and by Booking page. Filtering by booking lifecycle phase is useful if you only want specific types of lifecycle events to trigger your Zap.

Filtering by booking lifecycle phase when using the Booking Lifecycle Event trigger

When using the Booking Lifecycle Event trigger, a Zap is triggered every time the status of one your bookings changes. The following statuses, or lifecycle events, can trigger a Zap: Scheduled, Rescheduled, Canceled, Completed, and No-show.

Without filtering, this trigger will create a new record every time a booking is canceled or completed. If you wish to prevent this, you should limit the trigger by filtering it. Below are the steps to set up this filter:

  1. Log in to Zapier, go to Zaps, and click on the Zap you want to edit.

  2. Add a Filter step by clicking on the + symbol on the left panel in the Zapier Editor (see Figure 1).

    Figure 1: Add a Filter step

  3. Click on the Filter button to add the Filter (see Figure 2).

    Figure 2: Click on the Filter button


    Click Continue (see Figure 3).
    Figure 3: Click Save + Continue

  4. Set up and test the Filter. A couple of examples are shown below.

    1. Example 1: Allow only the “Scheduled” event to trigger the Zap.
      Select the Booking – Status option in the 1st drop-down field. Select the (Text) Exactly matches option in the 2nd drop-down field and type “Scheduled” in the 3rd text field (see Figure 4).
      Figure 4: Example

      NoteThe (Text) Exactly matches filter is case-sensitive. Make sure you use a capital S for "Scheduled".


    2. Example 2: Allow both the “Scheduled” and “Rescheduled” events to trigger the Zap. Repeat the steps in Example #1. Next, click on the + OR button. In the new added row, select the Booking – Status option in the 1st drop-down field. Select the (Text) Exactly matches option in the 2nd drop-down field and type “Rescheduled” in the 3rd text field (see Figure 5).

      Figure 5: Example 2: Allow both the Scheduled and Rescheduled events to trigger the Zap

Filtering by Booking page

When you have multiple Booking pages and you wish to track a specific Booking page, you will need to set up a Filter. Setting up this Filter is done the same way described in the section above. The difference is in the Filter definition.

Note

By default, you can only trigger Zaps from Booking pages you own. OnceHub Administrators can be allowed to trigger Zaps from all Booking pages in the account by enabling a permission in the Administrator’s profile.

To define the Filter:

  1. Select the Booking page - Public link option in the 1st drop-down field (see Figure 6).

    NoteAlways use the Booking page’s public link because it is unique. Do not use the Public name or Internal label because they are only unique to your account.

  2. Select the (Text) Exactly matches option in the 2nd drop-down field and type or paste the Booking page’s public link (see Figure 6). The Booking page’s public link can be copied from the Overview section in the Booking page settings in your OnceHub account (see Figure 7).

    Figure 6: Filter setup

    Figure 7: Overview section in the Booking page settings

Was this article helpful?
Thank you for your feedback!