Sales
Daily gross sales last 30 days, split by location and channel (POS, online, invoices).
pullslistOrderslistPayments
Square · Live
Ask Square how online and in-person stack up.
Read Square orders, payments, items, and inventory across in-person and online channels so the agent can answer omnichannel sales questions.
- Auth
- OAuth
- Access
- Read-only
- Plan
- Every plan
- Freshness
- Live — every call hits Square's API
- Available on
- Every plan
Examples
Questions teams actually ask.
The tools it pulls from are shown inline — every answer in Lumen cites the underlying records it read.
Inventory
Current stock for our top 20 SKUs by 30-day sell-through, flag any below 7-day cover.
pullslistInventoryCountslistOrders
Customer
Repeat-purchase rate from POS customers in our flagship location over the last 90 days.
pullslistCustomerslistOrders
Scope
What Lumen sees. What it can change.
Read is on by default. Every write is a separate toggle, capped per user, and logged.
Read
What Lumen reads
Lumen calls Square's REST API with the OAuth token you grant at install. Read scope only by default.
- Locations
List, address, status, currency, time zone
- Orders & payments
Search by date / location / state; line items; tender breakdown; tips and discounts
- Catalog
Items, variations, modifiers, current price, image
- Inventory
Current counts by SKU and location; recent adjustments
- Customers
Lookup, contact info, recent purchases, lifetime value
Write · opt-in
What Lumen can write
Lumen does not write to Square by default. Catalog updates, inventory adjustments, and refunds can be admin-enabled per location.
Every call is logged with user, operation, location, resource ID, and date range. Exportable as CSV.
Install
Connect in under a minute.
No keys, no call, no app marketplace fine print.
- Authorize01
Connect with Square OAuth
In Settings → Integrations → Square, click Connect. Sign in to Square and approve the read scopes Lumen requests.
- Pick locations02
Choose which locations
If your Square account spans multiple locations, pick which ones the agent should query. The token is stored encrypted, scoped to those locations.
- Ask03
Try a warm-up question
Start with "Daily gross sales last 30 days by location" — the agent will pull orders and aggregate by day.
Connect Square. See online and in-person at once.
OAuth. Read-only by default. Catalog/inventory writes opt-in.