Documentation & trust

Shopify integration: Approved · View on the Shopify App Store

StoreAdOps in Shopify Admin

Account Overview and Platform Connections

Install and open

Install or open StoreAdOps from Shopify Admin. Shopify provides your store identity and read-only permission request. Account Overview reads this store with your current staff permissions; no separate login or AI client is needed for Shopify reporting. Manage products, orders and inventory in Shopify Admin itself. The embedded app has no catalog editor or campaign-management screens.

Account Overview

Choose 7, 30 or 90 completed days in the store's time zone. Today and Shopify test orders are excluded. Order revenue is original product revenue after discounts, excluding tax, shipping, refunds and later edits. Average order value divides that revenue by eligible orders. Original order gross is not Shopify Analytics Gross sales. Zero is shown only for a verified empty result; unavailable or partial results are never replaced by zero or sampled totals.

Advertising snapshots use the same reporting services as the standalone dashboard. Only complete spend is aggregated, separately by currency. Provider attribution can overlap and is never added to Shopify revenue. Ad accounts are not mapped to the store; contribution and missing costs stay unknown.

Platform Connections

  1. Choose Connect workspace in Platform Connections to include your existing ad accounts.
  2. Sign in to StoreAdOps if needed. Check the displayed Shopify store and StoreAdOps account, then choose Connect workspace to approve reporting and account selection. Return to the original Shopify tab; it finishes connecting automatically. Requests expire after 10 minutes.
  3. View enabled advertising connections and explicitly choose an already-authorized account. This also updates your standalone workspace selection. Connect/reconnect and verified key-based account setup use the secure first-party workspace and provider authorization screens.

Linking is specific to your staff identity. Disconnect any time. A historical Google-only link must be removed and explicitly approved again; it is never silently expanded. The reporting link cannot create API keys, access administration, change Shopify permissions, create ads or modify campaigns.

Free plan and recovery

No payment method or automatic paid upgrade is required. Platform Connections displays the store's free allowance and reset date. Advertising reads use the linked workspace's allowance. Provider and rate limits still apply.

If access is denied, ask your store administrator to review staff permissions. Historical-order access is required for 90 days; 7 and 30 days remain available. Reopen after an expired session. Uninstalling revokes installation and workspace-link access. Reinstalling requires fresh authorization.

Contact support@storeadops.ai. See Privacy and Terms. Shopify controls suspension, installation availability and review approval.

Shopify API and data handling

Shopify reads use the GraphQL Admin API. The configured scopes are read_all_orders, read_inventory, read_orders, read_products, read_reports. The effective grant can be narrower. Historical-order access is required for the exact 90-day view; without it that view stays unavailable. No write scopes are requested.

Shopify staff access uses signed, short-lived App Bridge ID tokens and online token exchange. An installing owner's offline credential is never substituted for staff permissions. StoreAdOps stores the store and staff identifiers, a keyed session fingerprint, an encrypted online credential with a maximum 60-second reuse window, and usage/security records. Optional workspace linking stores the explicitly approved account association. Catalog and order data is read live, not accumulated as a warehouse; customer contact fields are not requested.

HMAC-verified app/uninstalled webhooks revoke the installation and delete staff credentials and workspace links. HMAC-verified shop/redact webhooks remove installation identity and usage data and stored Shopify connections. customers/data_request and customers/redact are acknowledged; customer personal data is not stored. Separately authorized Google Ads safety history remains governed by the privacy policy.

Contact support@storeadops.ai for access or deletion requests. Installation availability and review approval are controlled by Shopify.

Shopify tools (13 provider tools)

StoreAdOps exposes the following read-only Shopify tools to connected AI clients:

Generated from the current named-tool registry. Every callable input schema is exposed in tools/list; get_capabilities reports account readiness only. Availability depends on connected accounts, permissions, assets and enabled features. Server exposure does not establish approval or availability in an installed ChatGPT or Claude client.

Read and analyze (13)

Bounded reads of account, campaign or commerce data. These tools do not change advertising or store resources.

verify_connection

Verify connection. Performs a live metadata-only check; never selects an account or changes authorization. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, shopify, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_store

Get store. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_products

Get products. Use detail=summary for compact catalog rows; get_product returns a chosen product's full details. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_product

Get product. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_product_images

Get product images. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_product_inventory

Get product inventory. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_product_margins

Get product margins. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

assess_product_ad_readiness

Assess product ad readiness. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

get_recent_orders

Get recent orders. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_orders.

get_order_summary

Get order summary. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_orders.

get_order_report

Get order report. Exact bounded completed store-local date coverage; gaps fail closed instead of inventing revenue. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_orders.

get_collections

Get collections. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.

recommend_products_for_ads

Recommend products for ads. Supported channels: shopify; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: read_products.
Shared StoreAdOps workflow tools (4)

These workspace tools are separate from the provider count above; they do not add advertising or commerce permissions.

get_connections_status
Check connected accounts and the selected account before starting.
get_capabilities
Check account readiness for already advertised tools; this does not grant access.
get_merchant_profile
Read the merchant objectives and guardrails saved in StoreAdOps.
get_change_status
Check a saved change's status and available readback; never retries a provider write.

A shared tool can support more than one platform, so platform counts should not be added together. Advertising changes require a preview, explicit confirmation and an idempotency key; listing a tool is not permission to execute it.