TL;DR
If store installation fails on Add shop, check your store URL (HTTPS, no trailing path), API key permissions (read/write), or re-run guided OAuth. After a successful install, confirm webhooks and sync in Settings → Webshop.
Common errors
Invalid store URL
- Use the site root, e.g.
https://yourstore.com— not/wp-adminor a product page. - The store must be reachable over HTTPS from the internet.
- Local or staging URLs need extra setup (tunnel or public URL).
API credentials rejected (manual connection)
- Create keys in WooCommerce: WooCommerce → Settings → Advanced → REST API.
- Permission must be Read/Write.
- Copy the full
ck_andcs_values with no extra spaces. - If keys were revoked in WooCommerce, generate new ones and retry.
Guided OAuth failed or was denied
- You must be logged in as a WordPress admin on the store.
- Approve all permissions when WooCommerce asks.
- If you see an error after redirect, return to Add shop and use Try again.
- Some hosts block OAuth callbacks — check security plugins or firewall rules.
Installation timed out or stalled
- Large catalogs can take several minutes on first sync.
- Watch the progress steps on Add shop — webhooks and catalog import run after the shop is created.
- If stuck for more than 15 minutes, retry; partial data is safe to re-sync.
Webhooks not registered
- Open Settings → Webshop for the shop.
- Use Reinstall webhooks if the health banner or ops view shows webhook issues.
- See Troubleshoot WooCommerce order sync if orders still do not appear.
Still stuck?
Contact support from the in-app chat (when enabled) or email support with:
- Store URL (not API secrets)
- Connection method (guided vs manual)
- Screenshot of the error on Add shop
- Approximate time the install failed