eBay

How to add an eBay store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

Sell on eBay and access 170 million active users in nearly 200 countries. Benefits like branded tracking pages, product information imports, order detail imports, and the eBay Global Shipping Program will help you to grow your brand and reach new markets.

Follow this link to learn about eBay Guarantee Delivery.

eBay Requirements

Connection Requirements:

  • An active seller account with eBay.

  • eBay username and password.

    The username field for eBay store connections has a limit of 50 characters. If a username exceeds 50 characters, you will receive an error.

Order Import Requirements:

  • Include a Ship To address.

  • Contain at least one item.

Connect an eBay store to ShipStation

To connect your eBay store to ShipStation:

Multiple eBay Stores

If you're connecting multiple eBay stores to ShipStation, we recommend you log out of any active eBay sessions before connecting the accounts.

  1. Select the eBay tile.

    eBay logo
  2. Click Connect.

    PU_eBay_Connection.png
  3. Log in to your eBay account to authorize the connection.

After you've completed the connection steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page to adjust the store-specific settings like branding, notification preferences, and product handling.

Available Features for eBay Integration

ShipStation's integration with eBay supports the following standard features:

Additional Features for the eBay Integration

ShipStation's integration with eBay allows for the following additional features:

Feature

Description

Imports orders that are part of the eBay Global Shipping Program

Orders that belong to the eBay Global Shipping Program will import into ShipStation alongside your other eBay orders.

Supports eBay Guarantee Delivery orders (Door-to-Door only)

ShipStation will import eBay Guarantee Delivery orders alongside your other eBay orders. ShipStation supports eBay Guarantee Delivery orders that use the Door-to-Door option.

Review our eBay Guarantee Delivery FAQ article for more details.

Supports eBay Order Number Identifier

ShipStation will import eBay's new Order Number format.

You must migrate to the new eBay integration to import the new order number format.

Support-enabled Features for the eBay Integration

In addition to the features listed above, the following settings can be enabled for your eBay store by the ShipStation User Success team.

Feature

Description

Custom Fields

Contact ShipStation Support to map the following eBay fields into ShipStation's three Custom Fields:

  • eBay External Transaction ID

  • eBay Item ID

  • eBay Order ID

Custom StatusesCustomer EmailsCustomer Phone NumbersRequested ServicePayment MethodDiscountsIdentifies Gift OrdersInternal NotesNotes from BuyerOrder WeightItem WeightItem ImagesItem OptionsItem Warehouse LocationStatus UpdateTracking NumberCarrierServiceCarrier FeeNote to BuyerItem Information

Additional Details about the eBay Integration

  • Any email communications sent from ShipStation to your customers must be in compliance with eBay's member-to-member policy. This means the emails cannot contain contact information like email addresses, phone numbers, or website URLs. Additionally, if using ShipStation's Branded Tracking Page, you cannot include non-eBay store URLs or social media links. eBay will begin blocking communications - including emails from ShipStation - that violate their member-to-member policy on June 7th, 2021.

    For guidance on how to best configure your shipment and delivery email templates to ensure they comply with eBay's policy, review our FAQ article about creating an eBay compliant email template and Branded Tracking page.

  • Item SKUs: To import Item SKUs from eBay into ShipStation, you'll need to add the Custom Label attribute to your listings and define the Custom Label for each. If you're not sure how to add the Custom Label to eBay listings, follow the steps below.

    Note

    This feature is only available if you're using eBay Selling Manager or Selling Manager Pro.

    1. Log in to your eBay account and navigate to Active Listings.

    2. Click the Customize link at the top right of the page.

    3. Check the Custom Label checkbox and it will be added to the list. You can change the order of how you want it to appear if you like. Click Apply.

      At this point, you should see a Custom Label column in your listings.

    4. Click [Add] to define the value for each listing.

  • Weight and Dimensions (dimensions will no longer import on the new eBay integration released on March 3rd, 2021).

    ShipStation will only receive item weight and dimensions if your store is using eBay's calculated shipping costs. If you're using flat-rate or free-shipping options, weight and dimensions will not be sent to ShipStation.

    Additionally, ShipStation can only import dimensions for single-item, single-quantity orders. If there's more than one product on an order, ShipStation will only import the weight.

  • Single shipment update only: ShipStation can only update an eBay order with shipment information once. If ShipStation tries to send eBay additional shipment updates, eBay will ignore them.

  • Automatic feedback unavailable in ShipStation: eBay no longer allows for feedback messages to be sent via ShipStation's store settings. You can still utilize eBay's Automatic Customer Feedback feature by setting it up directly in your eBay account.

eBay Troubleshooting Tips

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

Issue

How to troubleshoot or resolve

Error: Auth token has expired.

As a security measure, the authentication token eBay creates for third-party integrations like ShipStation expire after a set time. This error means the authentication token we're using has expired and needs to be renewed before you can update your eBay orders in ShipStation again.

To renew the token, reconfigure the eBay store's connection with ShipStation.

Error: Comment Too Long.

This error occurs on ShipNotify if your Automatic Customer Feedback message is over 80 characters.

Solution : Update the Automatic Customer Feedback to be less than 80 characters, then retry the shipment update. This eBay Help article explains the Automatic Customer Feedback feature in eBay, but not the 80 character limit.

Error: The username that was provided during store setup was not the same username that was authenticated on eBay. Please return to the store setup page and try again.

This error message means your eBay username is too long. The username field for eBay store connections has a limit of 50 characters. If a username exceeds 50 characters, you will receive an error because the username will cut off at 50 characters.

Solution: You'll need to do two things: change the username in eBay to be fewer than 50 characters and then reconfigure the store in ShipStation with the new store name. 

After you change the username in eBay, go in ShipStation to Settings > Selling Channels > Store Setup. Click Modify next to eBay on the Store Setup page,  enter the new username, and click Connect.

Cannot import orders after reconfiguring eBay within ShipStation.

If you have already tried reconfiguring the selling channel within ShipStation and you still cannot import orders, you can revoke an eBay token from the eBay side to force a reconfigure within ShipStation.

  1. Sign in to My eBay.

  2. Go to My Account > Sign in and Security > Third-Party App Access.

  3. Select Show under Third-party authorizations.

  4. Check the Revoke this authorization box and click Apply.

How can I identify my eBay Global Shipping Program orders?

All orders that are part of the eBay Global Shipping Program (GSP) use a standard address with an Address Line 1 that begins with "Reference #" to identify the orders. To make those orders stand out, or make them easier to filter, we recommend that you tag the orders with an automation rule.

  1. Create an order tag specifically for your GSP orders.

  2. Create an automation rule that looks for eBay orders with a Address Line 1 that begins with "Reference #" and applies the tag you created. Here's an example:

    Automation Rule Example for ebay
Custom StatusesCustomer EmailsCustomer Phone NumbersRequested ServicePayment MethodDiscountsIdentifies Gift OrdersInternal NotesNotes from BuyerOrder WeightItem WeightItem ImagesItem OptionsItem Warehouse LocationStatus UpdateTracking NumberCarrierServiceCarrier FeeNote to BuyerItem Information