The purpose of this article is to help you learn: 

  • How to create a new "Zap" in Zapier

 

Before You Begin

To create automated workflows, or "Zaps", you must have a Zapier account that is linked to BookingKoala. 

If you do not have a Zapier account, or it has not been connected to BookingKoala yet, click here to learn more. 

 

Setting Up Your First Zap

As part of the Zapier integration process, you have already started to create your first Zap.  You have already added a trigger to this Zap when connecting your account.

 

Locating Your Incomplete Zap

If you have logged out or navigated away from the "Add New Zap" page after connecting your account, log back in and select "Zaps" from the menu on the left.

Your Zap will be displayed under the "Home" section.  Click the three dots on the right and select "View" to open.

You will find yourself back on the "Add New Zap" page.  

 

Adding an Action

To add an action to the Zap, click the blue "plus sign" icon below the trigger box and an action box will be added.

Use the search bar to look up the app where you'd like the action to take place, or click the name of the app listed below.  

Next, select an Action Event. This is what is performed when the Zap is triggered. Action events depend on the functionality of the app you have selected.  

For example, if you are creating a Zap to automatically add new bookings to your Google Calendar, you could select "Create Detailed Event" as the action event.  

Once you've selected the action event, click "Continue".  

Below "Choose Account", sign in to the app using the blue "Sign in to [app name]" button.  

A pop-up window will appear where you can enter your login credentials for that app.  Some apps, like Google, may ask for permission before you can connect them. Click "Allow" to proceed. 

Once logged in, the account will be displayed under the Choose Account section.  Click the blue "Continue" button to proceed.  

 

Setting Up the Action

The final step is to set up your action.  The options for your action will depend on which trigger you have selected and the app performing the action.  

Any box that has "(required)" at the top right corner must have a text entered or a value selected.  

To insert a value into a field, click inside the box. If the box says "Enter text or insert data..." you can manually type in the value, or select it from a list of existing values.

If a box says "Choose value...", you can select a value supplied by Zapier, or select a Custom value from BookingKoala.  

Once you have entered your values, click the blue "Continue" button at the bottom of the page.  

The final step is to test your action to make sure it is working properly.  Scroll down to the bottom of the page and click the white "Test & Review" button on the left. 

If the Zap was set up correctly, you will see a "Test was successful!" message at the top of this section.  You can open the other app to check that the action indeed took place.  

 

Troubleshooting Your Zap

If something was configured incorrectly, you will see a red message letting you know that the action could not be carried out.  Any values contributing to the error will be displayed in the box below.

For more information on how to troubleshoot the error, click the black "Troubleshoot Error" button on the right.  

To fix the error, go back to the "Set Up Action" tab and locate which field is causing the issue.  Once you've made your adjustments, click the blue "Continue" button at the bottom of the page.

You will be brought to the Test Action section again.  Scroll to the bottom and click the white "Retest Action" button.

Repeat this process until it says "Test was successful!" at the top of the section.

 

Enabling Your Zap

Once everything has been set up and you are ready to automate this workflow, click the blue "Turn on Zap" button.

A pop-up window will let you know that the zap has been turned on. 

This action will now be performed automatically whenever the event happens in your BookingKoala account. 

 

Details Synced to Zapier

The following tables contain each value that is synced to Zapier. The column on the right shows the value's name and the column on the left shows an example of the value type.

Customer

id 1234
first_name John
last_name Doe
company_name Cleaning with Meaning
primary_email john_doe@example.com
gender male
primary_phone_number 1234567890
address Chicago Avenue
zipcode/postal code 60601
city Minneapolis
state Minnesota
apt 25A
note This is a test note for the customer.
is_new 0/1
tags [Onetime, Recurring, Important]

 

Bookings

id 1001
industry Home Cleaning
form Form 1
location_type Service Area/Merchant Location
location Chicago
zipcode/postal code 60601
service_category Flat Rate Service
is_service_hourly yes/no
service_hourly_value 120
frequency Every 4 weeks
occurrence onetime/recurring
frequency_repeat_slug every_4_weeks
created_on 1619674829
booking_date 2021-04-16
arrival_time 15:00:00
day Friday
tip $10.30
parking $5.00
bonus $7.00
provider_ids [3, 4]
provider_email test_provider@example.com
provider_emails [test_provider@example.com, test_provider2@example.com]
customer_id 544
customer_name John Doe
customer_first_name John
customer_last_name Doe
customer_email john_doe@example.com
customer_phone 1234567890
tags [Onetime, Recurring, Important]
address Chicago Avenue
city Minneapolis
address_zipcode/postal code 60601
state Minnesota
apt 25A
key_info at_home/hidden
key_note Please be sure to lock the doors when you leave.
key_with_provider true/false
alert_charge_now true/false
alert_charge_text alert! you are about to charge this booking
alert_reminder_admin true/false
admin_email_reminder_date 2021-04-16
admin_email_reminder_day_before 2
admin_email_reminder_hours_before 4
admin_email_reminder_message Test reminder message
coupon $20.00
gift_card $100.00
referral_discount $50.00
referral_amount $20.00
adjusted_price $150.50
adjusted_time 120
payment_method existing_credit_card
new_credit_card
cash
special_notes This is a test special note.
provider_note Please check all stuff correctly after cleaning.
booking_note Take extra care with this booking.
service_total $115.00
expedited_amount $50.00
frequency_discount_amount $10.00
discounted_total $155
booking_tax $12.30
service_fee $10.00
total $177.30
rating 4.5
review You did an awesome job!
review_date 1619674829

 

Canceled Booking

All fields from booking trigger +  
canceled_bookings single/all
cancellation_reason Not at home