Zapier Setup Guide

Connect Starworks to 6,000+ apps and automatically sync customers

What is Zapier?

Zapier is an automation platform that connects different apps together. It allows you to automatically send customer data from your booking system, POS, or accounting software directly to Starworks without any coding.

Popular Use Cases

Sync new customers from Fresha to Starworks
Import Square appointments as Starworks customers
Add Xero contacts to your review campaigns
Sync Booksy clients automatically

Before You Start

Enable Webhooks in Starworks

Go to Settings → Customer Sync and toggle "Enable Webhooks" to ON

Copy Your Webhook URL & Secret

You'll need both the Webhook URL and Secret from the Customer Sync page

Create a Free Zapier Account

If you don't have one already, sign up at zapier.com

Step-by-Step Setup

Step 1: Create a New Zap

Log into your Zapier account
Click "Create Zap" in the top right
Name your Zap something like "Fresha to Starworks" or "Square to Starworks"

Step 2: Set Up the Trigger

Search for your source app (e.g., "Fresha", "Square", "Booksy", "Xero")
Select the trigger event (usually "New Customer" or "New Client")
Connect your account and authorize Zapier
Test the trigger to make sure it's working

Tip: If your app isn't available on Zapier, you can use "Webhooks by Zapier" to connect any system that sends webhooks.

Step 3: Configure the Action

Click "Add Action"
Search for and select "Webhooks by Zapier"
Choose "POST" as the action event
Click "Continue"

Step 4: Configure Webhook Settings

URL

Paste your Starworks Webhook URL (from Customer Sync settings)

https://yoursite.com/api/webhooks/customers/YOUR_BUSINESS_ID

Payload Type

Select: JSON

Data (JSON)

Map your source app's fields to Starworks fields:

{
  "event": "customer.created",
  "data": {
    "firstName": [Map from trigger],
    "lastName": [Map from trigger],
    "email": [Map from trigger],
    "phone": [Map from trigger]
  }
}

Click in each field and select the corresponding data from your trigger app

Headers

Add these two headers:

Header Name:Content-Type

Value:application/json

Header Name:X-Webhook-Signature

Value:[Your Webhook Secret]

Step 5: Test Your Zap

Click "Test & Continue"
Zapier will send a test customer to Starworks
Check your Starworks Customer Sync activity log to verify it worked
If successful, click "Publish" to turn on your Zap

Field Mapping Examples

Fresha Field Mapping

Starworks Field	Fresha Field
`firstName`	Client First Name
`lastName`	Client Last Name
`email`	Client Email
`phone`	Client Phone

Square Field Mapping

Starworks Field	Square Field
`firstName`	Given Name
`lastName`	Family Name
`email`	Email Address
`phone`	Phone Number

Xero Field Mapping

Starworks Field	Xero Field
`firstName`	First Name
`lastName`	Last Name
`email`	Email Address
`phone`	Phone Number

Troubleshooting

Error: "Invalid webhook signature"

Make sure you've copied the webhook secret exactly from the Customer Sync page and added it to the X-Webhook-Signature header.

Error: "Missing required fields"

At minimum, you must provide either firstName or email. Check that you've mapped at least one of these fields from your trigger.

Issue: Customer not appearing in Starworks

Check the "Recent Activity" log on the Customer Sync page to see if the webhook was received. If you see an error, it will show what went wrong.

Need Help?

If you're having trouble setting up Zapier or need help with a specific integration, we're here to help!

Contact Support Back to Customer Sync