Etsy

Etsy provides a marketplace for merchants who sell upcycled, vintage, and handmade products. The Etsy e-commerce community benefits both sellers and their customers with a well-updated blog, in-app notes from buyers, coupon codes, discount amounts, and carrier tracking information. Etsy integrates directly with ShipStation to automatically import your orders so you can start shipping quickly. ShipStation will automatically notify your Etsy account with each order's shipment details as soon as you create each label.

Etsy Requirements

Connection Requirements:

  • An active seller account with Etsy.

  • Your Etsy username and password (NOTE: the username field is case sensitive in the ShipStation pop-up).

  • Your Etsy shopname.

Your Etsy Username is Different from Your Login Credentials

The username you use to connect your Etsy account to ShipStation is not the same username that you use to log into Etsy. It is a separate username automatically generated by Etsy when you created your account.

To locate your Etsy username, perform a People Search on Etsy. Click your name in the search results to pull up your Etsy profile.

Your Etsy username will be visible at the end of the profile URL, after the backslash:

Image: Etsy website with arrow pointing to username in the URL.

Alternatively, perform a Shops Search on Etsy to locate your store, then click the name of the Shop Owner to pull up your Etsy user profile.

Learn more about your username from the Etsy Help Center.

Order Import Requirements:

  • Be a non-wholesale order.

  • Include a Ship To address.

Turkish Etsy Stores: Please note that Turkish Etsy stores do not automatically import the ship-to address into ShipStation. As a result, you will need to manually enter the address for each order.

Connect an Etsy Store to ShipStation

To connect your Etsy store to ShipStation:

Connecting to multiple Etsy stores?

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

  1. Select Etsy.

    Image: Etsy logo. Button that reads, Connect
  2. Enter your Etsy Username, then click Find My Shops. This field is case sensitive.

    Connect your Etsy Store form with Etsy Username highlighted.

    Your Etsy Username is Different from Your Login Credentials

    The username you use to connect your Etsy account to ShipStation is not the same username that you use to log into Etsy. It is a separate username automatically generated by Etsy when you created your account.

    To locate your Etsy username, perform a People Search on Etsy. Click your name in the search results to pull up your Etsy profile.

    Your Etsy username will be visible at the end of the profile URL, after the backslash:

    Image: Etsy website with arrow pointing to username in the URL.

    Alternatively, perform a Shops Search on Etsy to locate your store, then click the name of the Shop Owner to pull up your Etsy user profile.

    Learn more about your username from the Etsy Help Center.

  3. Select the store you want to connect from the Available Shops drop-down.

    Image: Connect your Etsy Store popup with Available Shops drop-down highlighted.
  4. Click Connect.

    At this point, you'll be redirected to Etsy to confirm access for ShipStation. If you're not already logged in to Etsy, you'll be prompted to log in.

  5. Click Allow Access on the next page to grant ShipStation access to your Etsy store.

    Image: Etsy's Confirm Access popup. Allow Access button highlighted.

After you've completed the connection steps, the store's Settings page will open. You can adjust your store-specific settings like branding and customer notifications, if you wish. Or click Save to close.

Available Features for Etsy

The ShipStation integration with Etsy supports the following standard features:

Order Status Mapping

ShipStation Status

Etsy Status

Awaiting Payment

Unpaid

Awaiting Shipment

Paid

Shipped

Shipped

Cancelled

Not Supported

On Hold

Not Supported

Data Sent with Shipment Notification

This table indicates which data ShipStation sends to Etsy with the marketplace shipment notification:

Field

Sent to Marketplace?

Status Update

Green checkmark. Supported feature. Yes.

Tracking Number

Green checkmark. Supported feature. Yes.

Carrier

Green checkmark. Supported feature. Yes.

Service

Red X mark. Unsupported feature. No.

Carrier Fee

Red X mark. Unsupported feature. No.

Note to Buyer

Red X mark. Unsupported feature. No.

Item Information

Red X mark. Unsupported feature. No.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Additional Etsy Features

The ShipStation integration with Etsy allows for the following additional features:

Feature

Description

Custom Field Mapping

You can map the Etsy Gift Wrap + Price to one of ShipStation's custom fields. To do this, go to Settings > Selling Channels > Store Setup and click Edit for your Etsy store. In the Store Settings tab, set the drop-down for the custom field you wish this information to map to and save your changes.

New orders that import after this setting has been saved will map the Gift Wrap and Price to the selected custom field in the order.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Etsy Integration Notes

  • ShipStation does not display Etsy's Ship By Date. Currently, we map the Etsy Expected Ship By Date to ShipStation’s Ship by date field.

  • Etsy no longer includes your buyer's Etsy username in the order data sent (to ShipStation or to third-party platforms). Instead, the Buyer ID is a string of numbers, unique to each Etsy customer. ShipStation uses this number as the Marketplace Username when creating a Customer Record, which identifies your Etsy customers and their order history in ShipStation. Use the order number and buyer email to locate the order inside your Etsy dashboard.

    ODET_Etsy-Recipient-BuyerID_MRK.png
  • ShipStation cannot identify when Etsy orders are cancelled. If an Etsy order is cancelled, we recommend that you cancel the order in ShipStation as well.

  • If an order is Sold In Person, ShipStation will use the item's name as both the name and SKU for the product.

  • Etsy only accepts one tracking number per shipment.

Etsy Troubleshooting Tips

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

Issue

How to troubleshoot or resolve

Error: Receipts is not a valid value for Int32

What it means: This error is typically due to an incorrect Etsy username when you try to connect Etsy to ShipStation. It typically means that the username entered into ShipStation is incorrect or incorrectly formatted.

What to do: Reconfigure your Etsy store and ensure you are using your Etsy username and not login name.

This field is case-sensitive, so make sure you're using the username exactly as it appears in Etsy.

Error: (404) Not Found

What it means: This error occurs when you try to connect Etsy to ShipStation. It typically means that the username entered into ShipStation is incorrect or incorrectly formatted.

What to do: Reconfigure your Etsy store and ensure you are using your Etsy username and not login name.

This field is case-sensitive, so make sure you're using the username exactly as it appears in Etsy.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information