> For the complete documentation index, see [llms.txt](https://docs.boomerangme.cards/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.boomerangme.cards/integrations/toast-pos.md).
# Toast POS
Setting Up the Toast Integration (General guide)
This article explains how to connect Toast to Boomerangme. This is the main, general guide. After connecting the integration, you also need to set up the loyalty card itself — there are separate articles for each card type: [Stamp](/cards-creation/stamp.md), [Reward](/cards-creation/reward.md), [Discount](/cards-creation/discount.md), [Cashback](/cards-creation/cashback.md), [Membership](/cards-creation/membership.md).
*the video shows the same steps described below in text. You can watch the video or read the article — whichever works better for you.*
#### Before you start
> ⚠️ For the integration to work, the restaurant's Toast account needs access to third-party integrations — the **Restaurant Management Suite** (about $50/month, gives access to 200+ Toast partners). This is a Toast requirement, not a Boomerang one. If this isn't purchased, the integration won't work.
A video from Toast on how to buy this subscription:
### Step 1. Connect Boomerang in Toast
1. In Toast, go to **Integrations → Browse & purchase integrations**.
2. Search for **Boomerang →** **Add now**.
3. You'll see the **"Manage your Boomerang integration"** page — here you choose which location(s) you're giving permission to connect.
4. Click the locations field — the **Select locations** window opens, where you can pick one or more locations (or a whole location group).
5. Click **Select location.** After that, a form will appear asking you to agree to the terms and conditions; you must accept them.
After this, the integration will appear in your **My Integrations** list — this means Toast and Boomerang now have permission to exchange data. Nothing else needs to be done on this page.
### Step 2. Turn on rewards on the POS
For rewards set up in Boomerang to show up on the POS terminal, you need to turn this on separately in Toast:
1. Open **Rewards Program** (in Toast, this is under Marketing → Loyalty).
2. **Enable Loyalty** — select **Yes**. This turns on the Rewards button on the POS terminal.
3. Click **Save**. ❗ Be sure to click "Publish Changes."
> ❗ If you skip this step, rewards won't show up on the POS terminal, even if the integration is connected.
### Step 3. Check that menu items are visible
For point-earning rules based on specific products to work correctly, menu items need these visibility settings turned on:
* **POS**
* **Kiosk, Toast Order and Pay**
* **Toast Online Ordering, Local by Toast App**
You'll find these toggles both at the menu level (**Manage Menus → \[menu] → Visible To**) and at the individual item level (**Channel visibility**, when creating or editing an item). Other options (Customer invoices, Online ordering partners) are optional — they don't affect how the integration works.
Click **Save**. ❗ Be sure to click "Publish Changes."
ℹ️ After making changes, always click **Save**, then **Publish all changes** — otherwise the changes won't take effect.
### Step 4. Check your employees
Under **Employees**, make sure there are employees who have access to the POS terminal.
* You can add a new employee (**Add New Employee**) and assign them a role.
* Every employee has a **POS access code** — a short numeric code (3–8 digits) used to log into the Toast POS app. Code login can be turned off, but that's up to the restaurant owner.
### Step 5. Get the location's GUID
> ℹ️ To connect in Boomerang, you'll need a special location identifier from Toast called a **GUID**. This is not the same as the **Restaurant ID** — they're easy to mix up, but you need the GUID for this step.
You can get it two ways:
1. Ask your Toast account manager — they can give you the GUID for each location.
2. Find it yourself: click the current location's name at the top of the page (next to the Toast logo) — a list of locations opens. Hover over the location you need — a link appears in the bottom-left corner of the browser, containing a `guid=...` parameter. That part of the link (the letters and numbers after `guid=` and before `&`) is the identifier you need.
> ℹ️ If you have more than one location, each one has its own unique GUID.
### Step 6. Connect the integration in Boomerang
The integration is connected from the business owner's account (sub-account), not from the agency account.
> ⚠️ Log in to the sub-account through the domain [**https://app.boomerangme.com/**](https://app.boomerangme.com/). If you log in through a different domain/address, the Toast integration won't appear in the list.
1. Open **Settings → Integrations →** block **Add Integration**
2. Find **Toast** in the list and click **Connect**.
3. In the **Integration configuration** window that opens:
* Choose the loyalty card you want to connect.
* Paste the location's GUID into the **"Restaurant ID"** field. Click **Submit**.
❗ Even though the field is called **"Restaurant ID,"** you need to paste the **GUID** from Step 5 here — not the numeric Restaurant ID from Toast. If you copied the whole link, make sure to remove everything except the GUID itself (format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`) — no `?guid=` at the start, and no `&returnUrl=...` at the end. Extra characters or spaces will cause an error.
If everything is entered correctly, the integration will appear under **Active integrations** with status **Active**, linked to the card you chose.
#### Multiple locations
If you have more than one restaurant location, repeat Steps 5–6 for each one separately: get that location's GUID → connect it with its own **Connect** click using that GUID. The same loyalty card can serve several locations at once. You don't have to connect every location right away — you can add them one at a time, whenever it's convenient.
#### What's next
The integration setup itself is now done. Next, you need to set up the loyalty card itself — the point-earning rules and rewards. This is covered in separate articles for each card type:
* Reward card
* Stamp card
* Discount card
* Cashback card
* Membership card
