Card VaultAI← Home

Connecting eBay

Authorize the vault to list on your eBay seller account — a one-time OAuth flow.

Last updated May 11, 2026

The vault talks to eBay through their official Sell API. To publish listings on your behalf we need a one-time OAuth grant from your seller account — eBay tells us who you are, hands us a refresh token, and we use that token to manage listings, fetch inventory, and pull order data.

Before you start

You'll need an active eBay seller account in good standing. The OAuth scopes we request are limited to the inventory and listing endpoints — we never see or store your eBay password.

Step by step

  1. Open Connections → eBay from the sidebar (or visit /connections/ebay).
  2. Click Connect eBay. You'll be redirected to ebay.com to sign in if you aren't already.
  3. Review the requested permissions and click Agree. eBay redirects you back to the vault with an authorization code.
  4. The vault exchanges that code for an access + refresh token, encrypts both at rest, and stores the connection against your account.
  5. You'll land on the eBay overview page showing your seller ID, marketplace (US / UK / AU / DE), and connection status.

What the connection unlocks

Once connected you can:

  • Sync Business Policies — pull your existing payment, shipping, and return policies from eBay so listings inherit them automatically. Visit /connections/ebay/policies to trigger a sync.
  • Build Marketplace Templates — bundle a Business Policy set plus default category, location, and condition into a reusable preset at /connections/ebay/marketplace-templates.
  • Publish listings — from any card detail page or batch view, click List on eBay. The vault assembles the offer using your active template, validates it against eBay's requirements, and publishes.
  • Receive inventory + order updates — the vault polls eBay daily for status changes and writes them back to your cards.

Disconnecting

You can revoke the connection at any time from the eBay overview page. That deletes both tokens from our database and asks eBay to invalidate them on their side. No new listings can be published until you reconnect.

Multi-region

Currently US (EBAY_US) is fully supported. UK, AU, and DE marketplaces are on the Wave 5 roadmap.