Selling channels
Marketplace connections
A connection is an authorized link between your CrowPrime organization and one marketplace seller account. CrowPrime never stores marketplace passwords — access is granted through the channel's own OAuth consent screen.
How connecting works
- 1
Start the flow
Connections → Add connection → pick the channel. Choose the region or marketplace first where the channel requires it.
- 2
Consent on the marketplace
You are redirected to the channel, sign in with the seller account and approve the requested scopes.
- 3
Return and store
The channel redirects back with an authorization code. CrowPrime exchanges it for an access token and a refresh token, stores them encrypted, and records granted scopes and expiry.
- 4
Initial import
Listings, then historical orders within the backfill window, then inventory reconciliation.
Note
Only Owners and Admins can create or remove connections. Other roles see the connection list read-only.
eBay
Requirements
- An eBay seller account in good standing with Business Policies enabled.
- The account owner must approve the consent screen; secondary users often lack app-grant rights.
Scopes requested
sell.inventory read + write listings and quantities
sell.fulfillment read orders, upload tracking
sell.account read business policies and site settings
sell.finances read payouts and fee breakdowns (optional)Multiple eBay sites (for example .de and .co.uk) under one seller account are covered by a single connection; listings carry their site code.
Amazon
Requirements
- A Professional Selling Partner account (Individual accounts lack the required API access).
- Region selection — North America, Europe or Far East — made before authorization; a separate connection is needed per region.
Notes
- Amazon throttles heavily; CrowPrime queues pushes and retries with backoff, so quantity updates can take a few minutes at peak times.
- FBA orders are imported as fulfilled-by-channel and are excluded from your fulfillment queue, but still count towards turnover and invoicing.
- Buyer emails are anonymized by Amazon; invoices use the provided billing name and address.
Etsy
Note
The Etsy integration is rolling out and may not be enabled for your organization yet. If the Etsy option is missing under Integrations, contact support — everything below describes its behavior once enabled.
Requirements
- An open Etsy shop with the shop owner available to authorize.
- Etsy access tokens are short-lived, so the refresh cycle runs more frequently than on other channels.
- Etsy variations map to CrowPrime product variants; each variation must have a SKU to participate in stock sync.
- Digital listings are imported but excluded from inventory sync.
Capability comparison
| Capability | eBay | Amazon | Etsy |
|---|---|---|---|
| Import listings | Yes | Yes | Yes |
| Push stock quantity | Yes | Yes | Yes (SKU required) |
| Push price | Yes | Yes | Yes |
| Create new listings from CrowPrime | Yes | Limited (existing ASIN required) | Yes |
| Import orders | Yes | Yes | Yes |
| Upload tracking | Yes | Yes | Yes |
| Issue refunds via API | Yes | Yes | Partial — some cases require the seller portal |
| Fee data for net revenue | Yes | Yes | Partial |
Import listings
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Yes
Push stock quantity
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Yes (SKU required)
Push price
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Yes
Create new listings from CrowPrime
- eBay
- Yes
- Amazon
- Limited (existing ASIN required)
- Etsy
- Yes
Import orders
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Yes
Upload tracking
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Yes
Issue refunds via API
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Partial — some cases require the seller portal
Fee data for net revenue
- eBay
- Yes
- Amazon
- Yes
- Etsy
- Partial
Common connection errors
| Message | Meaning | Resolution |
|---|---|---|
| invalid_grant | The authorization code expired or was reused | Restart the connect flow |
| insufficient_scope | Consent granted fewer scopes than required | Reconnect and accept all requested permissions |
| seller_not_professional | Amazon plan does not allow API access | Upgrade the Amazon selling plan |
| shop_not_active | Etsy shop is in vacation mode or closed | Reopen the shop, then reconnect |
| rate_limited | Channel API quota exhausted | No action; CrowPrime retries automatically with backoff |
invalid_grant
- Meaning
- The authorization code expired or was reused
- Resolution
- Restart the connect flow
insufficient_scope
- Meaning
- Consent granted fewer scopes than required
- Resolution
- Reconnect and accept all requested permissions
seller_not_professional
- Meaning
- Amazon plan does not allow API access
- Resolution
- Upgrade the Amazon selling plan
shop_not_active
- Meaning
- Etsy shop is in vacation mode or closed
- Resolution
- Reopen the shop, then reconnect
rate_limited
- Meaning
- Channel API quota exhausted
- Resolution
- No action; CrowPrime retries automatically with backoff
Note
For Kaufland, Shopify, TikTok Shop, AliExpress, DHL, sevDesk and banking, see More channels & services — the OAuth flow and token handling are the same, only the prerequisites differ.