Shipping with ShipStation - BETA

Beta Disclaimer. Please note the ShipStation integration is currently in limited beta testing. If you would like to participate in our beta program, please email or contact your Sales Account Manager.

ShipStation is a web-based shipping solution for eCommerce retailers. Designed to streamline the fulfilment process, ShipStation integrates with all major eCommerce shopping carts and shipping and fulfilment platforms. 

NOTE: If you don't intend to use a shipping fulfilment service, you can set up your own predefined shipping rates; for more information, see Setting up a shipping method and rates.

This article explains how to get started with ShipStation and includes these topics:

About ShipStation API rate limits

ShipStation has a rate limit on the number of API calls to their system. The current rate limit for each  ShipStation API Key/Secret pair is 40 requests per minute. When an API Key/Secret pair reaches this limit, ShipStation will refuse further API connection requests until the time resets (at the beginning of the next 60 seconds). The potential impacts to your online store include:

  • No shipping method will be available at checkout for your customers, if ShipStation is the only carrier.
  • You'll be unable to print shipping labels.
  • You'll be unable to update the ShipStation integration in the eCom Back Office.

To avoid exceeding ShipStation's API rate limit, we recommend that you:

  • Limit the number of carriers that you set up with ShipStation to 2.


  • Schedule maintenance activities that entail multiple API requests, such as bulk printing shipping labels, during your store's off-peak (low activity) hours.

NOTE: In general, you should perform all bulk activities through your ShipStation account (instead of through eCom). 

Getting started with ShipStation

  1. Sign up for ShipStation
    1. Set up a shipping carrier or carriers
    2. Select a label layout
    3. Get your API Keys from your ShipStation account
  2. Configure ShipStation in the eCom Back Office
  3. Set up international shipping with ShipStation

1. Sign up for ShipStation

Click here to sign up for ShipStation. 

a. Set up a shipping carrier or carriers with ShipStation

NOTE: Before proceeding, make sure you have an account with the shipping carrier(s) that you want to set up with ShipStation. 

  1. Log in to your ShipStation account.
  2. Once you're logged-in, click Welcome at the top-left.


  3. On the Welcome page, click the link to add a shipping carrier and follow the on-screen prompts.

b. Select a label layout in ShipStation

  1. Log in to your ShipStation account.
  2. Once you're logged-in, click Welcome at the top-left.
  3. On the Welcome page, click the link to select a label layout and follow the on-screen prompts.

c. Get your API Keys from your ShipStation account

  1. Log in to your ShipStation account.
  2. Once you're logged-in, click the gear icon at the top-right to access your account settings.
  3. From the menu to the left, click Account.
  4. Click API Settings.


  5. Under API Keys, copy the values for API Key and API Secret. You'll need to paste these values when configuring ShipStation in the eCom Back Office. 

2. Configure ShipStation in the eCom Back Office

  1. Log in to the eCom Back Office.
  2. From the main menu on the left, go to Settings > STORE SETTINGS > Shipment Methods.
  3. Click Connect ShipStation and configure the following options:



  • Enable this integration - Toggle this setting to the on position for ShipStation to be available in your online store.
  • API key - Paste the API key you copied from your ShipStation account here.
  • API Secret - Paste the API Secret you copied from your ShipStation account here.

NOTE: Click Save after entering your ShipStation login information to retrieve the carrier(s) you've set up with ShipStation.



  • Tax rate - Select the tax rate for your location. Do not use this option if you are located in North America (United States or Canada). Taxes are calculated automatically for North American stores, provided you've set this up for your store under Settings > PAYMENT SETTINGS > Taxes.
  • Phone - Enter the phone number associated with your Lightspeed account.



  • Insurance - Toggle this setting to the on position if you want shipments (both domestic and international) above a certain amount to be insured; then, specify the amount.
  • Insurance provider - Select an insurance provider from the drop-down.
  • International non-delivery option - Specify how you want carriers to treat international packages that are not delivered.



Enter your company's mailing address; this will appear on return shipment labels.


Manage the carriers and service levels that you offer to your customers. 

To manage carriers, you need to first set up the carriers with ShipStation. Once you've set up your carriers, they'll appear in the eCom Back Office and in your online store.

NOTE: For carriers to sync with your ShipStation configuration in eCom, you must click Save after entering the API Key and Secret (in the LOGIN INFORMATION area). 

By default, Lightspeed eCom enables all the carriers you set up and their corresponding service levels. Depending on your business needs and your customer demographic, you may want to only offer certain carriers and service levels. For example, if you see a trend that most of your customers use the least expensive service level, perhaps disabling more expensive service levels will increase their likelihood to purchase.

To manage your carriers and service levels:

  1. From the main menu of the eCom Back Office, go to Settings > STORE SETTINGS > Shipment Methods.
  2. Click Configure ShipStation.
  3. Scroll down to the CARRIERS section.


  4. The carriers you've set up with ShipStation appear here. If a particular carrier does not appear, click Sync carriers.
  5. Manage your carriers and shipping methods by:
    • enabling/disabling their Show during checkout toggles.
    • clicking Edit to select or deselect a carrier's service levels.


  6. Click Save.

Set up international shipping with ShipStation

When all the products in a buyer's shopping cart have affiliated HS (Harmonized System) tariff codes, they will have the option of international shipping with ShipStation at checkout.  

  1. From the main menu of the eCom Back Office, go to Settings > GENERAL SETTINGS > Advanced.
  2. Under STORE, enable HS Codes.
  3. Click Save. Return to the main dashboard.
  4. From the main menu of the eCom Back Office, go to Settings > STORE SETTINGS > Shipping Methods.
  5. Click Configure ShipStation.
  6. Configure the new options under SETTINGS.
  7. Click Save.

To add HS codes to products:

  1. Select the product on the Products page.
  2. Under INVENTORY & VARIANTS, click the corresponding variant to open the Edit variant popup.
  3. Under IDENTIFIERS, enter a Harmonized System code in the HS code field. Only the first 6 digits of the HS code are necessary. Click Find an HS Code below the field if the code is unknown.
  4. Click Save.

Repeat the procedure for all products that you want to make available for international shipping.

Have more questions? Submit a request || || Request a callback