Integrate YGB with Kisi
Your Golf Booking (YGB) is a golf booking management platform that integrates with Trackman simulators. By integrating YGB with Kisi through Zapier, you can automatically grant access to golf simulator rooms when customers make paid bookings, ensuring seamless entry for your guests.
This is a webhook integration based on Kisi events.
Prerequisites
- Kisi organization administrator rights
- YGB account with webhook access
- Zapier account
- Golf simulator rooms with Kisi hardware configured
Generate a Kisi API key
You need to have organization administrator or organization owner rights to create an API key. We recommend creating API keys from the organization owner's account, to avoid the API key becoming invalid when an organization admin loses their admin rights.
- Sign in to Kisi
- On the top right corner, click on your name and click on My Account
- Next, select the API tab and click on Add API Key
- Enter your name, your Kisi password, and your verification code and click Add
- Copy the API key shown on the screen and click Close
Prepare YGB to send webhook data
- Sign in to your YGB dashboard.
- Navigate to Admin Panel > Settings > Manage Integrations.
- Click Create New Integration.
- Name your integration (e.g., "Kisi Access Control").
- Select Webhook as the integration type.
- Select the trigger event: Purchase Paid.
- Leave the webhook URL field empty for now (you'll get this from Zapier in the next step).
- For more information follow YGB's guide on setting up a webhook.
If you cannot access the Manage Integrations page, you may not have the appropriate permissions. Contact your YGB administrator to grant you access or to set up the integration.
Create the Zapier integration
- Sign in to Zapier.
- Click Make a Zap and choose Webhooks by Zapier as the trigger.
- Select Catch Hook as the trigger event.
- Click Continue.
- Copy the generated Custom Webhook URL.
- Return to YGB and paste this URL into the webhook configuration.
- Save the webhook settings in YGB.
Set up the Kisi action in Zapier
- In your Zapier setup, add a new Action step.
- Search for and select Kisi from the app list.
- Choose Create Access Link as the action.
- Connect your Kisi account using the API key you generated earlier.
- Click Continue.
Map the webhook data to Kisi fields
Configure the field mapping as follows:
Kisi Field | Map From YGB Webhook |
---|---|
User's Email Address | Purchase User Email |
Group ID | Create a group with access needed for the booking, click Copy ID, and paste it |
Name | Purchase User First Name + Purchase User Last Name |
Start Time | Purchase Line Items Booking Start |
End Time | Purchase Line Items Booking End |
View Zapier field mapping interface
Test the integration
- Complete a test purchase in YGB to trigger the webhook.
- Check that an access link is created in Kisi with the correct details.
- Confirm the user receives the access notification.
- Test physical access to ensure the integration works end-to-end.
Once testing is successful, publish your Zap. The integration will then run automatically.
Synchronization behavior
- Access granted: Immediately when a purchase is marked as paid in YGB
- Access duration: Based on the booking start and end times from YGB
- Access scope: Limited to the golf simulator group configured in the mapping
- Notifications: Users receive Kisi access notifications when access is granted
This integration uses Zapier as a bridge between YGB and Kisi. Ensure your Zapier account remains active for the integration to function properly.