# Connecting Union POS Connect a store's Union POS with the API key and client ID from Union, and Mays brings in its sales every 10 minutes. One client ID covers one venue and one Mays location. For: Admins · On: Web · [Help Center](https://www.mays.app/help) › [Integrations](https://www.mays.app/help/integrations) · Last updated October 8, 2026 · Mays Team Connect a store's Union POS with the API key and client ID that Union gives you, and Mays brings in the store's sales every 10 minutes. **Who:** admins. In a custom role, this is the **Connect / disconnect / sync integrations** permission. Union POS is part of **Integrations**, which is in the Basic and Pro plans and the free trial. **Before you start:** ask your Union contact for the venue's **API key** and **client ID**. One client ID covers one venue, and connects to one Mays location. For a second store, you connect again with that venue's client ID. ## Connect 1. Go to **Integrations** and find **Union POS** under **Add Integration**. 2. Click **Connect**. Once one venue is connected, the button reads **Connect Another Location**. 3. In **Connect Union POS**, paste the **API key**. The eye icon shows what you pasted. 4. Type the **Client id**. 5. Pick the Mays **Location** this venue is. 6. Click **Connect Union**. Mays checks the key with Union first (*Checking the key…*). ![The Connect Union POS window: Union issues an API key and a client id per venue. Ask your Union contact for both — one client id covers one venue, so connect again for a second location, with the API key hidden, the Client id box, the Location list set to South and the Connect Union button](https://mays-uploads.s3.us-east-2.amazonaws.com/site/help__connect-union-pos__01-connect-union-pos.456bcef7cf.png) The window closes, and **Union POS** appears under **Connected**, named after the last six characters of the client ID. The first sales arrive within 10 minutes. If it doesn't connect, the window says why: - *Union rejected the API key — check the key and client id.* - *That location already syncs sales from square.* A location takes its sales from one POS only. Unmap it from Square first. See [Integrations overview](https://www.mays.app/help/integrations/integrations-overview). - *Could not connect — check the API key and client id.* ## What comes into Mays Every 10 minutes, Mays reads the last two days of the venue's tickets: the items, modifiers, discounts, taxes, service charges and total on each one, plus the tips from its payments. Voided, canceled and refunded tickets aren't counted as sales. Those sales feed: - **Revenue** on [Prime cost](https://www.mays.app/help/reports-insights/prime-cost) and [Labor cost insights](https://www.mays.app/help/reports-insights/labor-cost-insights); - **Actual sales** in the scheduling reports and forecast; - the **tip pool**, from the tips; see [Tip pooling](https://www.mays.app/help/time-clock/tip-pooling); - **inventory**, when you map the items you sell to recipes; see [POS mapping and automatic depletion](https://www.mays.app/help/inventory/pos-mapping-and-depletion). Union doesn't send your staff, shifts, menu or customers to Mays. ## Good to know - **Older sales:** when you connect with a location, Mays brings in that location's last 30 days of sales in the background. After that, each sync reads back two days. For sales older than 30 days, write to Mays support. - **Syncing by hand:** the sync icon on the Union card and **Sync Sales** in **Configure → Sync History** bring in the last two days of sales straight away. You rarely need them: sales sync every 10 minutes. - **Sync History can look fine when it isn't.** If Union stops accepting the key, for example after it's been replaced, the runs still show as successful with nothing new. If sales stop appearing, connect again with the new key, the same client ID and the same location. Mays updates the existing connection. - **Moving a venue to another location:** under **Configure → Location Mapping**, click the bin icon next to the old location. It's removed straight away, with no confirmation. Then connect again with the same client ID and the new location. The **Map** button on that tab doesn't work for Union. - **User Mappings** stays empty for Union, because Union doesn't send staff. - **Disconnecting** is the bin icon on the card. Syncing stops and sales already in Mays stay. Connect again with the same client ID to carry on. ## Related articles - Integrations: [Integrations overview](https://www.mays.app/help/integrations/integrations-overview) — What Mays connects to — Square, 7shifts, Union POS, Google Business, Govee thermometers, Dropbox and Google Drive — who can connect them, and how to check, sync or disconnect a connection. - Integrations: [Connecting Square](https://www.mays.app/help/integrations/connect-square) — Connect each store's Square account so Mays gets its sales, payments, tips and refunds, sold-out items and team. Admins and managers can connect; one Square location per Mays location. - Inventory: [POS mapping and automatic depletion](https://www.mays.app/help/inventory/pos-mapping-and-depletion) — Map each item you sell in Square or Union to a recipe, and every night Mays takes that recipe's ingredients out of stock for what you sold. - Reports & insights: [Prime cost](https://www.mays.app/help/reports-insights/prime-cost) — Prime Cost puts each day's sales next to its labor cost and theoretical food cost, and shows the share of sales each one takes. Web app, admins by default. - Time clock: [Tip pooling](https://www.mays.app/help/time-clock/tip-pooling) — Pool a location's tips and share them out by hours worked, equally or by FTAR score — choose who takes part, keep managers out, and pay the shares through the payroll export. - Scheduling: [Sales forecast and labor budget](https://www.mays.app/help/scheduling/sales-forecast-and-labor-budget) — See each day's projected sales from your POS history next to the weather, adjust the projection, and compare it with scheduled labor and your weekly labor budget. - Scheduling: [Scheduling reports](https://www.mays.app/help/scheduling/scheduling-reports) — Ten ready-made reports on sales, labor, hours, overtime, time off, attendance, the shift pool and tips — for any date range, one location at a time, with CSV export. ## Still need help? Send us a support request and a real person on the Mays team will get back to you. [Contact support](https://www.mays.app/contact?topic=support) · [Call +1 (561) 286-3939](tel:+15612863939) Canonical: https://www.mays.app/help/integrations/connect-union-pos