> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/integrations/integration-reference/booker.md).

# Booker

Connect Booker appointments, sales and customer data to your loyalty program.

## Integration at a glance <a href="#capabilities-and-use-cases" id="capabilities-and-use-cases"></a>

* **Appointments** — Reward qualifying appointment activity.
* **Purchases** — Reward series, treatments, products and packages; refund handling is supported.
* **Memberships** — Reward qualifying membership/package purchases and restrict earning by membership status.
* **Membership tier rewards** — Confirm availability for your connection with your Perkville representative. Tier rewards require membership types and active statuses to sync to Perkville; a sign-up or purchase reward alone does not establish tier support. See [Membership tiers](https://docs.perkville.com/features/earning-rules/membership-tiers.md).

{% hint style="warning" %}

* **Limitations** — The listed integration does not include pre-booking rewards or automatic redemptions.
  {% endhint %}

Your configured rules determine which eligible activities award points and which workflows are enabled.

## Integration Steps

1. **Account Setup in Middle**\
   Your Perkville Customer Success Representative (CSR) will coordinate with you to initiate the integration through our platform, **Middle**.\
   You will receive an invitation via email to set up your Middle account.

> **Important:** Make sure the email address used belongs to a **Booker admin user**, as admin access is required for the integration.

2. **Complete Registration**\
   Follow the link in the email and set a password to complete your Middle account registration.
3. **Authorize the Integration**\
   Once registered and signed in to Middle, follow these steps:

* Click on the **“Booker” app** in the top left corner
* Select **“Edit Connection Details”**
* Enter your **store name** in the “Business Name/ID” field and click **Save**
* Click **“Launch OAuth Flow”**

  > ⚠️ Be sure you’re logged into a **Booker admin account** when completing the OAuth process
* Follow the prompts to complete authorization

4. **Send Location IDs**\
   After successfully completing the OAuth connection, email your **Booker Location ID(s)** to your Perkville CSR.

## FAQ

### Can refunds reverse purchase points?

Refund handling is supported. Agree which sales rules and refunds qualify when configuring the integration.

See the [Booker partner profile](https://partners.perkville.com/partners/booker) for additional integration information.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/integrations/integration-reference/booker.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
