Sites

Connect and manage e-commerce sites (Etsy, Amazon Seller, TikTok, Shopify). Covers OAuth, Amazon marketplace selection, on-demand sync, and site listing/detail.

📄️ Get OAuth authentication URL for connecting a new site

Generate OAuth authorization URL to connect e-commerce platforms. Supports Etsy, TikTok, and Amazon. Returns URL for user to complete platform authentication. State is signed with JWT for security and expires in 15 minutes.

📄️ Get site details

Get detailed information about a specific connected e-commerce site including sync status, product counts, and quota information

📄️ List connected e-commerce sites

Get all e-commerce sites connected to your workspace (Etsy, TikTok, Amazon, Shopify)

📄️ OAuth callback endpoint — consumed by platform providers after user consent

Platform-agnostic OAuth callback. Called by Etsy, Amazon (Seller & Ads), Shopify, TikTok, WooCommerce after the user authorizes the app. NOT intended to be called directly by partner code — Dodgeprint registers this URL as the OAuth redirect target. For Amazon specifically: Amazon does NOT support custom `redirect_url` per request, so after the user completes OAuth the partner must POLL `GET /v1/sites?platform_id=5&sort=-id&limit=1` every 5 seconds (timeout 2 minutes) to detect the newly created site. This endpoint is documented for completeness only.

📄️ Trigger a manual sync (orders / products / transactions) for one or more sites

Dispatch background jobs to fetch data from connected platforms. Supports Amazon (Seller), Etsy, WooCommerce, and others via `site_id` or `site_ids`. Rate-limited to 5 syncs per hour per (site, type). Returns 202 immediately — progress must be polled via `GET /v1/sync-progress/{site_id}` (separate endpoint). Provide EXACTLY ONE of `site_id` or `site_ids`.