Connect

SHOPLINE: connect an International store over OAuth

TL;DR

SHOPLINE (the International platform at myshopline.com) connects over the registered OAuth app: enter the store handle, approve the scopes on SHOPLINE, done. Agents then read store info, products and orders, compute an exact server-side sales summary, watch daily orders/revenue for anomalies, and — when write scopes are granted — change products, prices and inventory through a write gateway that always pauses for your approval. Access tokens live about 10 hours and refresh automatically.

Which SHOPLINE this is (and isn't)

Two different platforms share the SHOPLINE name. This integration covers the INTERNATIONAL platform — stores whose admin lives at your-store.myshopline.com (developer.shopline.com APIs).

Stores on *.shoplineapp.com (SHOPLINE Taiwan/Hong Kong) run a completely different API and cannot connect here.

Connect a store

On /integrations, open the SHOPLINE card, enter the store handle (my-store or my-store.myshopline.com) and click Authorize via SHOPLINE. You'll approve the app's scopes on SHOPLINE and land back on the integrations page.

The consent screen lists read scopes (store information, products, orders, customers, inventory) and write scopes (products, orders, inventory). Granting write scopes does NOT make the agent autonomous — every store change still stops at the in-app approval gate before it runs.

Tokens are encrypted at rest, scoped to your organization, auto-refreshed server-side (~10h lifetime), and never returned to the browser.

What the agent can do

CapabilityToolNotes
Store health / report headerget_shop_infoName, currency, timezone.
Productsget_productsStatus, vendor, price range, inventory (limit 50 per page).
Ordersget_ordersTotals, financial/fulfillment status, line items (limit 100).
Sales numberssales_summaryExact server-side aggregation: revenue, AOV, by-day series, top products.
Monitoringdetect_anomaliesDaily orders + revenue vs a weekday-aware baseline.
Anything else (read)admin_getAny documented Admin REST GET path — customers, fulfillment orders…
Store changesadmin_mutatePOST/PUT/DELETE + path + payload. Approval-gated, single-attempt, response verified.

Related