eBay Integration Setup

📋Before You Start

• Active eBay seller account
• eBay account must be in good standing (not restricted)

🔧Setup Steps

1. 1
   Start the eBay OAuth flow in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → eBay. Click Connect with eBay. You will be redirected to eBay's sign-in page.
2. 2
   Sign in to eBay and authorize Pythias

   Sign in with your eBay seller account. On the authorization screen, review the permissions Pythias is requesting: Sell Orders, Sell Fulfillment, Sell Inventory, Sell Finances, and Sell Analytics. Click Agree to authorize.
3. 3
   Select your eBay site(s)

   After authorization, Pythias will ask which eBay site(s) to sync (eBay.com, eBay.co.uk, eBay.de, etc.). Select all sites where you have active listings and click Save.
4. 4
   Configure fulfillment defaults

   Set your default shipping carrier and service for eBay orders. eBay requires tracking numbers to be uploaded within 1 business day of payment for Seller Protection. Enable the Auto-upload tracking option in the integration settings.

🔄What Gets Synced

• ✓Paid orders (pulled every 5 minutes)
• ✓Order items, eBay item IDs, SKUs, quantity, and buyer shipping address
• ✓Shipment confirmation with carrier, tracking number, and ship date
• ✓Order status updates (Awaiting Shipment → Shipped)
• ✓Buyer messages (read in Pythias, optional)
• ✓Finance data and payout summaries (read-only)

💡Tips & Troubleshooting

• ⚡eBay OAuth tokens expire after 18 months. Pythias will alert you before expiry so you can re-authorize without interruption.
• ⚡Upload tracking within 1 business day to maintain eBay Seller Protection coverage on all transactions.
• ⚡If you sell on multiple eBay sites, each site uses the same OAuth token — select all applicable sites in the integration settings.