Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spotzee.com/llms.txt

Use this file to discover all available pages before exploring further.

Three different actions, three different outcomes. Pick the right one for what you’re trying to do.
ActionWhat happens to dataStatus afterReversible
DisconnectImported data preserved. Sync paused.Disconnected (grey)Yes, by reconnecting
DeleteImported data wiped. Integration removed.RemovedNo
ReconnectSame data preserved. OAuth refreshed.Connected (green)n/a

​
Disconnect

What it does. Pauses the integration. Webhooks stop firing into Spotzee, scheduled syncs stop running. Your already-imported customer records, orders, and product data stay in Spotzee. Use it when:
  • You’re temporarily pausing syncs (during a store migration, a Shopify plan change, or a long debug session).
  • You’re troubleshooting and want to stop new data flowing while you investigate.
  • You’re not sure whether you want to fully remove the integration but want to stop new activity.
How:
1

Open the store card menu

Inside the project, open Integrations and find the store card.
2

Choose Disconnect

Use the card menu and pick Disconnect. Confirm at the prompt: “Are you sure you want to disconnect? You can reconnect later.”
After disconnect, the status badge flips to Disconnected (grey). The store remains in your integration list. Reconnect later from the same menu when you’re ready.

​
Delete

What it does. Removes the integration entirely. Imported customer records that came from this Shopify store are removed from Spotzee. The integration card disappears from your Integrations page. The OAuth grant in Shopify is revoked. Use it when:
  • You’re permanently moving away from a store (closing the store, switching platforms).
  • You imported data into the wrong project and want to wipe and start over.
  • The store has been replaced by a different Shopify store at the same domain (rare, but happens with rebrands).
Be careful. Delete is destructive and irreversible. If you might want this data back, disconnect instead and decide later. How:
1

Open the store card menu

Use the card menu on the store you want to remove.
2

Choose Delete

Pick Delete. Confirm the destructive action prompt explicitly. Spotzee describes what gets removed before you confirm.
3

Wait for cleanup

Deletion of the customer records can take a few minutes for stores with large imports. The card disappears once cleanup completes.
After delete, the only way to bring the data back is to connect the store fresh and run an initial sync. Customer external IDs in Spotzee for that store are reset, so even a fresh connect treats every customer as new.

​
Reconnect

What it does. Refreshes the OAuth grant. Used when status shows Reconnect required (amber badge) or when you’ve added new sync-back permissions and need updated scopes. Sync settings, customer list assignment, history, and existing data are all preserved. Only the OAuth credentials change. Use it when:
  • Status is Reconnect required.
  • You uninstalled and reinstalled the Spotzee app in Shopify.
  • You enabled a sync-back toggle that needs a scope you didn’t grant on the original install.
  • The connecting Shopify user’s permissions changed.
How:
1

Open the store card menu

Use the card menu and pick Reconnect.
2

Re-approve on Shopify

You’re sent through the same OAuth flow as the initial connect. Re-approve permissions on Shopify.
3

Land back in Spotzee

On approval, the store flips back to Connected (green) and syncs resume.

​
Picking the right action

A simple decision tree:
  • Want to stop syncing temporarily? Disconnect. Reversible.
  • Want to fix an OAuth or scope issue? Reconnect. No data loss.
  • Want to permanently remove the store and its data? Delete. Irreversible. Confirm twice.
When in doubt, disconnect. You can always come back.

​
Next steps

Sync operations

Status badges, retries, and re-syncs.

Store details

The five-item readiness checklist.

Connect a store

The OAuth flow used by both initial connect and reconnect.

Troubleshoot

Diagnose connection problems before deciding to delete.