Skip to content
ShopifyWooCommerceShopware 6Magento 2PrestaShopOpenCartBigCommerceJTL-ShopGambioEcwidWixSquarespaceAmazoneBayEtsy

Connect eBay with ProductPolish

Connect your eBay Seller Account with ProductPolish via the eBay REST API. You create an app in the eBay Developer Program and generate an OAuth User Token.

Prerequisites

  • An active eBay seller account
  • An eBay Developer account (free)
  • Business Policies (shipping, payment, and return policies) must be set up in your eBay account

Required credentials

FieldExampleDescription
App ID (Client ID)MyShop-App-PRD-...The App ID (Client ID) of your Production app.
Cert ID (Client Secret)PRD-...The Cert ID (Client Secret) of your Production app.
OAuth User Tokenv^1.1#i^1#r^...A user token with the required scopes.
Fulfillment Policy ID123456789012ID of your shipping policy (Business Policy).
Payment Policy ID123456789012ID of your payment policy.
Return Policy ID123456789012ID of your return policy.

Step-by-step guide

1

Create eBay Developer account

Go to developer.ebay.com and register with your eBay account. Registration is free.

2

Create Application Keys

Navigate to: My Account→Application Keys

Click "Create a keyset" for the Production environment.

Enter an app name (e.g. ProductPolish).

After creation you will see:

  • App ID (Client ID)
  • Dev ID (not needed for ProductPolish)
  • Cert ID (Client Secret)
3

Generate OAuth User Token

Navigate to: My Account→User Tokens

Select your Production app and click "Get a User Token".

Select these scopes:

  • sell.inventory – manage inventory
  • sell.account – read account information
  • sell.fulfillment – fulfillment information

Click "Sign in to Production" and authorise the app with your eBay seller account.

After authorisation you receive an OAuth User Token (starts with v^1.1#i^1#).

eBay generates an Access Token (valid 2 hours) and a Refresh Token (valid 18 months). ProductPolish uses the Refresh Token to automatically generate new Access Tokens. Note when you created the token and renew it before the 18-month expiry.
4

Set up Business Policies

If you do not have Business Policies yet, go to the eBay Seller Hub:

Account→Business Policies

Create one each:

  • Shipping policy (Fulfillment Policy)
  • Payment policy
  • Return policy
If you already have eBay listings, these policies probably already exist.
5

Find Policy IDs

For each policy ID, go in the Seller Hub to Account→Business Policies.

Click on the respective policy. The Policy ID is in the browser URL:

...ebay.com/bpf/policy/123456789012

Copy the ID for each of the three policies.

6

Enter in ProductPolish

Go in ProductPolish to Dashboard→Integrations→New connection.

  1. Select eBay as the platform
  2. Enter the App ID (Client ID)
  3. Enter the Cert ID (Client Secret)
  4. Paste the OAuth User Token
  5. Enter the Fulfillment Policy ID
  6. Enter the Payment Policy ID
  7. Enter the Return Policy ID
  8. Click "Save connection"
Done! ProductPolish can now create and edit eBay listings via the Inventory API.

Good to know

  • Inventory API vs. Trading API: ProductPolish uses the modern Inventory API (RESTful) rather than the older Trading API (XML).
  • Listings: Products are created as "Fixed Price" listings (no auction format).
  • Categories: You must assign the eBay category after import, or ProductPolish attempts automatic category assignment based on the product title.
  • Token expiry: The Access Token expires after 2 hours and is automatically renewed via the Refresh Token. The Refresh Token itself is valid for 18 months.
  • Images: eBay has strict image guidelines: minimum 500x500 pixels, no watermark, no text on images.
  • Sandbox vs. Production: Always use Production keys. Sandbox keys only work in the test environment.

Common issues

"Invalid access token"

The user token has expired (after 18 months) or was generated with the wrong environment (Sandbox instead of Production). Create a new token.

"No Business Policies found"

You must first create shipping, payment, and return policies in the Seller Hub.

Production Keys not available

eBay releases Production Keys only after you have described a valid use case. Describe your integration as "Inventory Management / Product Listing Tool".

Policy ID not visible in URL

Some eBay regional sites display the ID differently. Alternatively, you can retrieve the Policy IDs via the eBay Account API.