Looking for help?

Search for articles, videos, and step-by-step instruction guides

Integrations

Creating Zaps in Zapier

Learn how to create automated workflows in Zapier to automate tasks relating to your BookingKoala account.

Last updated on 27 Jan, 2022

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.

Image

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

Image

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

Image

 

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.

Image

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.  

Image

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.  

Image

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. 

Image

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

Image

 

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.  

Image

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.

Image

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

Image

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. 

Image

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.  

Image

 

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.

Image

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

Image

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.

Image

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

Image

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

Image

 

Enabling Your Zap

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

Image

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

Image

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

Did you find this article helpful?
Previous

Google Analytics and adding tracking codes

Next