Connect Your Etsy Shop

1. Go to Settings → Integrations (open Integrations).
2. Click "Connect Etsy Shop". The button shows "Connecting..." briefly, then sends you to Etsy's own sign-in and approval page.
3. On Etsy, review and approve the permissions Ardent Seller requests: read your shop and profile info, read and update your listings, and read your orders and transactions (the scopes are listings_r, listings_w, transactions_r, profile_r, and shops_r).
4. After you approve, Etsy sends you back to the Integrations page and the Set Up Connection wizard opens.

If you decline on Etsy, nothing is connected — you'll see "You declined the connection request" and can try again any time. If the approval link sits too long and expires, just start over from "Connect Etsy Shop".

The wizard asks for three things before syncing begins:

• Default Location (required) — the location where imported orders are recorded and where stock is counted for the push back to Etsy. If you work from one place, that's your primary location; see Locations & Entities if you have several.
• Import Window — how far back to import sales history: "Last 3 days", "Last 7 days", "Last 30 days", "Last 90 days", "Last 6 months", "Last year", or "All time". The default depends on your plan, and you can backfill more history later.
• Auto-Create Products (off by default) — when on, Ardent Seller creates a product for every Etsy listing and links them for you. The wizard warns you if that could create duplicates of items you already track.

Click "Complete Setup" and the initial sync starts automatically: "Initial sync started. Listings will sync first, then photos, sales, and ledger transactions will be imported automatically." Depending on your shop size and import window, the first sync can take a little while — you can leave the page.

Each Etsy listing maps to one inventory item, and that link is what turns an Etsy order into a stock movement on the right product. Ardent Seller matches listings to items by SKU first. Listings without a SKU — common for digital listings — get a synthetic match key built from the listing's numeric ID, in the form ETSY-1234567890.

If you didn't use Auto-Create Products, link listings yourself on the connection's Listings tab: filter to unlinked listings, then link each one to an existing item or create a new product from the listing. You can also bulk activate, deactivate, or unlink listings there.

Opening stock: when a listing is linked (or a product is created from it) and the Etsy listing has quantity available, Ardent Seller records an initial transaction that seeds the item's on-hand quantity to match Etsy. That opening balance is dated at the start of your import window, so the sales history imported behind it subtracts correctly instead of double-counting. See How Stock Moves for how initial transactions work.

• Disconnect Shop revokes Ardent Seller's API access to your shop and stops all syncing. Your existing data — imported transactions, listings, sync history — is preserved. You can also revoke access from your Etsy account's own app settings at any time.
• Reconnect runs the Etsy approval again for the same shop (connecting a different shop this way is blocked). Your listing links and connection settings are restored where the items still exist, and a fresh sync catches up on the last 90 days.
• Delete Connection is only available after disconnecting, and it is permanent: it removes all listing mappings, sync history, and sales records associated with the connection. Imported transactions are preserved. This action cannot be undone.

The connection uses OAuth 2.0 with PKCE — the same authorization standard Etsy requires of all apps. You sign in on etsy.com, not in Ardent Seller, so your Etsy password is never shared with or stored by Ardent Seller. The access tokens Etsy issues are encrypted at rest with AES-256-GCM, and you can revoke access at any time — from the Disconnect Shop button here or from your Etsy account settings.