eBay + AtoShip
Import orders from your eBay seller account into atoship, buy discounted USPS / UPS / FedEx labels, and push tracking + fulfillment back — all via secure OAuth, no plugin required.
How it works
eBay uses OAuth 2.0 for secure authorization. You connect your seller account from the atoship dashboard, authorize access on eBay, and orders sync on a configurable schedule. When you purchase a label, tracking info is pushed back to eBay automatically.
Connect via OAuth
Authorize atoship on your eBay seller account
Orders sync on schedule
Paid orders import via the Fulfillment API
Buy label, order shipped
Tracking number pushed back to eBay automatically
Connecting your eBay account
Step 1 — Start the connection
In your atoship dashboard, go to Channels → Add Channel → eBay. Click Connect eBay Account to begin the OAuth flow.
Both eBay sandbox and production environments are supported. Sandbox is useful for testing before going live.
Step 2 — Authorize on eBay
You'll be redirected to eBay's consent screen. Review the permissions atoship needs (selling, fulfillment) and click I agree.
atoship requests access to your selling and fulfillment data. Your eBay password is never stored — only a secure, revocable OAuth token.
Step 3 — Verify the connection
After authorizing, you're redirected back to the atoship dashboard. Your eBay account should appear under Channels with status Active. You can immediately trigger a manual sync or configure auto-sync.
Order sync
atoship uses eBay's Sell Fulfillment API to pull orders. Orders are filtered by creation date and imported with full details including shipping address, line items, and payment info.
Sync methods
- Manual Sync — Click the "Sync Orders" button on your eBay store page to pull orders on demand.
- Auto Sync — Enable scheduled sync (every 1, 2, 4, or 8 hours) to keep orders flowing in automatically.
Sync window
Configure how far back to look for orders: 1 week, 2 weeks, or 1 month. Only orders within this window are synced. Orders already in the system are updated (not duplicated) using eBay's unique order ID.
Token management
eBay access tokens expire after 2 hours. atoship automatically refreshes tokens using the long-lived refresh token (valid for 18 months). If a refresh fails, the channel status changes to indicate re-authorization is needed.
Fulfillment & tracking
When you purchase a shipping label in atoship for an eBay order, the tracking number and carrier information are automatically pushed back to eBay via the Fulfillment API.
How tracking writeback works
- You buy a label in atoship (USPS, UPS, FedEx, etc.)
- atoship calls eBay's
POST /sell/fulfillment/v1/order/{orderId}/shipping_fulfillment - eBay marks the order as "Shipped" and shows tracking to the buyer
- eBay itself polls the carrier for transit updates (in_transit, delivered, etc.)
You only need to push the tracking number once. After that, eBay handles all carrier status polling and buyer notifications automatically — no ongoing updates from atoship are needed.
Sync settings
Click on your connected eBay store, then open the Order Sync tab. Here's what each option does:
Order Sync
- Auto Sync — Toggle automatic order imports on/off.
- Sync Frequency — How often to pull orders: 1, 2, 4, or 8 hours.
- Sync Window — How far back to look for orders: 1 week, 2 weeks, or 1 month.
Fulfillment & Tracking
- Update Fulfillment Status — When a label is purchased, automatically push tracking and mark the order as shipped on eBay.
- Send Tracking Emails — eBay sends tracking notifications to buyers when fulfillment is created. Toggle this off if you handle notifications yourself.
What gets synced
eBay → atoship
- Order ID, date, totals
- Shipping address (from fulfillment instructions)
- Line items with title, SKU, quantity, price
- Buyer username & email
- Payment status (paid, refunded, etc.)
- Fulfillment status (not started, in progress, fulfilled)
- Buyer checkout notes
atoship → eBay
- Tracking number
- Carrier code (USPS, UPS, FedEx, DHL)
- Shipment date
- Line item fulfillment details
- Order marked as "Shipped"
Order sync uses eBay's Fulfillment API with offset-based pagination. Duplicate orders are detected using eBay's unique order ID — syncing the same period twice won't create duplicates.
Status mapping
eBay uses separate payment and fulfillment statuses. atoship maps these to unified statuses:
Payment status
PAID→PAIDPENDING→PENDINGPARTIALLY_REFUNDED→PARTIALLY_REFUNDEDFULLY_REFUNDED→REFUNDEDFAILED→FAILEDFulfillment status
NOT_STARTED→UNFULFILLEDIN_PROGRESS→PARTIALLY_FULFILLEDFULFILLED→FULFILLEDDisconnecting
To disconnect your eBay account:
- From atoship: Go to Channels, click on your eBay store, and click Delete Store. Type "delete" to confirm. The OAuth token is revoked on the atoship side.
- From eBay: Go to your eBay account → Account Settings → Authorized Applications, find atoship, and revoke access.
Disconnecting does not delete any orders, labels, or tracking data already in atoship. It only stops future syncing.
Troubleshooting
OAuth redirect fails or times out
eBay's consent flow has a time limit. If you waited too long, go back to Channels and try again. Make sure pop-ups are not blocked for ebay.com.
Orders not syncing
Check the sync window setting — only orders within the configured time range are imported. Also verify your eBay account has recent orders with payment status "PAID". You can trigger a manual sync from the store settings page.
Token expired / re-authorization needed
eBay access tokens expire every 2 hours. atoship refreshes them automatically, but if the refresh token itself expires (after 18 months) or is revoked, you'll need to re-authorize by disconnecting and reconnecting the store.
Tracking not appearing on eBay
Ensure "Update Fulfillment Status" is enabled in your sync settings. The order must have a valid platformOrderId for tracking writeback to work. Check the channel logs if the push fails.
Sandbox vs production
Make sure you're using the correct environment. Sandbox orders won't appear in production and vice versa. The environment is shown on the store detail page.
Requirements
- eBay seller account (any tier — Starter, Basic, Premium, Anchor, Enterprise)
- Active listings and orders to sync
- No eBay app or plugin required — connection via OAuth only
- Supported marketplaces: US (ebay.com), with more coming soon