How to set up an eBay channel

eBay is a popular multinational online marketplace where individuals and businesses can buy and sell services, or new and used items.

In this article, you’ll learn how to create an eBay channel to create, manage, and list on eBay.

---

Before you start

You'll need

• An eBay account

Good to know

• eBay charges a fee per product added. Removing and re-adding products with rules, or having significant feed fluctuations, will create new listings and may result in unexpected costs. Note: Some eBay subscriptions allow you to list a set number of products for a monthly fee.

• We don't clear eBay APIs because this requires listing costs to be paid again.

If you want to keep your reviews and history for existing eBay listings, we can help. Contact our Support team for more information.

Step 1: Create your eBay channel

1. In Channable, go to Channels.

2. Search for and select eBay.

3. Set up your channel settings:

   1. Name: Provide a unique name for your channel. Used to identify it within Channable.

   2. Unique ID per item: Select the field containing your product IDs (this is often ‘id’).

   3. eBay country: Select the eBay country you want to list in.

      Note: The country you choose will influence the information you need to provide in later steps.

   4. eBay status: Select the publication level you want:

      • Verify only: Use this to test for errors without publishing your listings on eBay

      • Publish: Use this once you’re ready to publish your listings on eBay

   5. Use master rule group (optional): Add a master rule group or leave this empty.

4. Click Save.

Note: If you have selected the "Verify-only" option and activated the API, you will only see the number of errors in the "Preview" step. You will not see the number of successful products as you are not publishing anything yet.Note: Once you set the Status in the API settings from "Verify-only" to "Publish" you will not be able to switch back to the 'Verify-only' mode!

Step 2: Categorize your products

1. In [your eBay channel], go to the Categories step.

2. Our AI will automatically start to categorize your products to corresponding categories on Marktplaats.

3. Map (assign) categories for all remaining uncategorized items.

Step 3: Create rules to enrich, filter, and refine your product data

When your product data is incomplete or doesn’t match the format that eBay requires, you can use rules to tweak and optimize your product data to meet listing requirements.

1. In [your eBay channel], go to the Rules step.

2. Click Create rule.

3. Use rule templates or create a custom rule based on what you would like to adjust.

4. Click Save.

For more information on how to set up a rule, or rule combinations, refer to our rules articles.

Rule: Exclude listings if no stock (recommended)

eBay doesn't automatically remove listings if they're out of stock. Set up the following rule to automatically exclude and remove listings when no stock is available.

If stock is less or equal to 0

Take all fields and exclude.

Step 4: Map shared attributes

Tip: Click Auto-map fields to automatically fill these attributes based on AI. You can review the changes before you accept them.

1. In [your eBay channel], go to the Build step.

2. Map attributes marked as Required by marketplace.

3. If you're an eBay storefront owner, fill in your Storefront category ID and Storefront category name.

4. In the Profiles section, provide either the name or ID for your eBay Shipping, Payment, and Return profiles.

5. Go over and map any remaining attributes that are relevant for your business.

6. Click Save.

Information about Parent & child (product-listing variant) setups

To set up listings with variations (e.g., for size or color):

1. In the Items section, for Item Group ID, select the field containing your parent IDs.

2. Click on the Attributes-per-category tab and scroll to the Attribute variation level section.

3. Set the variant level(s) you’re using to true (e.g. if variants are color based, set Use “Color” on variant level to true.)

eBay will use the variant levels you selected to create different variants for parent products.

Note: If you don't want certain items to be grouped, make sure their unique ID is the same as the parent ID.

Detailed information about required attributes

Item section

• Item Group ID: Select the field containing your variant groups.

• ID type: Select the identification type for your products (e.g. EAN for EU, UPC for US).

• EAN / UPC: Select the field containing your product EANs (for eBay EU) or UPC (for eBay US).

• Condition: Click the dropdown, select Static values > [your product condition]. If your condition differs per product, map the fields containing your condition information. Note: For more information on eBay's condition information, refer to their article Item condition by category.

• Title: Select the field containing your product/vehicle titles.

• Description: Select the field containing your product/vehicle descriptions.

  Tip: You can add a graphic template to a listing by adding it to the Description field. You can use a combine rule to add your HTML and CSS template to your product description.

• Stock: Select the field containing your stock information.

• Category: If you have a multitude of products in different categories. You must use the right condition for that specific category. If your condition field does not contain the right value according to eBay, you can create a rule where you fill a field with the right value.

Price & Shipping section

• Currency: Click the dropdown, select Static values > [the currency of the country you're selling in].

• Price: Select the field containing your product prices.

• Location: Select the place your product is located.

• Shipping from: Select the country you’re shipping the product from.

• Dispatch time: Select the dropdown > Static values > [the number of days it will take you to ship the product after receiving the order].

Profiles section

To list on eBay, you need to provide either the name or ID for your Shipping, Payment, and Return profiles.

1. Scroll to the Profiles section.

2. Provide either the Name or ID for your Shipping profile:

   1. Shipping profile ID: Enter your unique Shipping profile ID in the text field, or click + to map the field containing that information.

   2. Shipping profile Name: Enter the name of your Shipping profile in the text field, or click + to map the field containing that information.

3. Provide either the Name or ID for your Payment profile:

   1. Payment profile ID: Enter your unique Payment profile ID in the text field, or click + to map the field containing that information.

   2. Payment profile Name: Enter the name of your Payment profile in the text field, or click + to map the field containing that information.

4. Provide either the Name or ID for your Return profile:

   1. Return profile ID: Enter your unique Return profile ID in the text field, or click + to map the field containing that information.

   2. Return profile Name: Enter the name of your Return profile in the text field, or click + to map the field containing that information.

5. Click Save.

Images section

• Click + Add. In the dropdown, select the field containing images (this is typically image_link). Click + Add again to add additional image fields

General Product Safety Regulation (GPSR) section (for EU sellers)

If you're selling on eBay within the EU, you need to comply with EU GPSR and DSA requirements by providing information about your EU responsible person and Manufacturer information.

Note: Make sure to provide information for the manufacturer address, street, city, postal code and country to prevent errors in your product listings.

• Product safety component

• Product safety pictogram code

• Product safety statement code

Manufacturer information

• Company name

• Email

• Phone

• Street

• City

• Postal Code

• State/province

• Country code

• Secondary address information

EU responsible person

• Company name

• Email

• Phone

• Street

• City

• Postal Code

• State/province

• Country code

• Secondary address information

Important: Check and map any remaining fields that are relevant for your business.

Step 5: Map category-specific attributes

Category-specific attributes are attributes that specifically apply to products from certain categories.

1. In the Build step, click on the Attributes per category tab.

2. Map any attributes marked as Required by marketplace.

3. Go over and map any remaining attributes that are relevant for your business.

4. Click Save.

Tip: Click Auto-map fields to automatically fill these attributes based on AI. You can review the changes before accepting them.

Step 7: Activate your channel

1. Select the Settings step in [your eBay channel].

2. At Linked seller account, click Select seller account > Connect with eBay. We'll redirect you to eBay to log in and accept requested permissions. Once accepted, you'll be redirected back to Channable.

3. Click Activate API.

4. Click Save.

5. Click Run now to send your product listings to eBay.

Note: If you selected Verify only as your eBay status, your products won't appear on eBay yet, but you'll receive error feedback from eBay in the Results step. Once you're ready to publish, change your eBay status to Publish and run your API again.

Step 8: Check your product listings for errors

Go to the Result step and click on the Feedback tab. This page displays all possible processing errors your product data has at a given moment.

Note: If a variant has an error, all other variants from the same listing will have an error.

Resolving errors

Important: Not all errors prevent your products from listing. We recommend following the steps and using your Successful tab as the source of truth.

1. In Description, click on the error name. This takes you to an overview of the products with that error.

2. In ID, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.

   1. If the error is a mapping error, click View in build to be directed to the attribute you need to map/re-map, which is highlighted in blue.

   2. For more information about the attribute and its accepted values, hover over .

3. Resolve the error.

4. Repeat for remaining errors. When you're ready, run your channel again by clicking Run now.

You can check your successfully listed products in the Successful tab.