Last updated on Mar 05, 2024

ShipStation is a cloud-based shipment platform that streamlines the shipping process for online retailers. It provides order processing, inventory management, creation of shipping labels, and customer communication all into one easy-to-use interface. It can be integrated directly with sellers (online or offline). It also allows you to track the shipment status and manage returns for an order.

ShipStation authenticates API requests from Hevo to access your account data with HTTP Basic authentication where the username is your API key and password is your API secret.


Obtaining the API Key and Secret

You require an API key and a secret to authenticate Hevo on your ShipStation account. These credentials do not expire and can be reused for all your Pipelines.

Note: You must log in as an Admin user or a user with the Admin privileges to perform these steps.

To generate the API Key and secret:

  1. Log in to your ShipStation account.

  2. In the top right of the page, click the Account icon.

    Account ShipStation

  3. From the drop-down menu, click My Profile.

  4. In the left navigation pane, under Account, click API Settings.

    Nav Bar

  5. In the API Settings page, under API Keys section, click Generate API Keys.

    Generate API Keys

  6. Copy the API Key and API Secret and save them securely like any other password.

    Copy API Keys

You can use these credentials while configuring your Hevo Pipeline.

Configuring ShipStation as a Source

Perform the following steps to configure ShipStation as the Source in your Pipeline:

  1. Click PIPELINES in the Navigation Bar.

  2. Click + CREATE in the Pipelines List View.

  3. In the Select Source Type page, select ShipStation.

  4. In the Configure your ShipStation Source page, specify the following:

    ShipStation config

  5. Click TEST & CONTINUE.

  6. Proceed to configuring the data ingestion and setting up the Destination.

Data Replication

For Teams Created Default Ingestion Frequency Minimum Ingestion Frequency Maximum Ingestion Frequency Custom Frequency Range (in Hrs)
Before Release 2.21 1 Hr 1 Hr 24 Hrs 1-24
After Release 2.21 6 Hrs 30 Mins 24 Hrs 1-24

Note: The custom frequency must be set in hours as an integer value. For example, 1, 2, or 3 but not 1.5 or 1.75.

  • Historical Data: In the first run of the Pipeline, Hevo ingests all the existing data for the selected objects from your ShipStation account and loads it to the Destination.

  • Incremental Data: Once the historical load is complete, all new and updated records for the Fulfillments, Orders, and Shipments objects are ingested as per the ingestion frequency. The remaining objects are ingested in Full Load mode.

Schema and Primary Keys

Hevo uses the following schema to upload the records in the Destination database:

Data Model

The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:

Object Mode Description
Carriers Full Load Contains the details of all the shipping provider companies connected to your ShipStation account.
Customers Full Load Contains the details of individuals or organizations who have placed an order.
Fulfillments Incremental Contains the details of orders that are shipped.
Marketplaces Full Load Contains the details of all the sellers that you can integrate with your ShipStation account.
Orders Incremental Contains the details of all orders placed by customers.
Packages Full Load Contains the list of orders available for shipment by a specific carrier.
Products Full Load Contains the details of items available for sale in the stores that are integrated with your ShipStation account.
Services Full Load Contains the list of shipping methods available for a carrier.
Shipments Incremental Contains the details of all orders for which shipping labels have been generated in your ShipStation account.
Stores Full Load Contains the details of all sellers integrated with your ShipStation account.
Users Full Load Contains the list of users that can access your ShipStation account.
Warehouses Full Load Contains the details of the locations where the order is shipped from or returned to.

Source Considerations

  • Pagination: An API response for each ShipStation object fetches one page with up to 500 records.

  • Rate Limit: ShipStation imposes a limit of 40 API calls per minute per API key and secret. If the limit is exceeded, Hevo defers the ingestion till the limits reset. Read API Rate Limits to know more about rate limits in ShipStation, and configure a suitable ingestion frequency for your Pipeline.

  • ShipStation supports the Pacific Standard Time (PST), and not UTC, due to which Hevo displays the position of the incremental objects in PST.


  • Hevo currently does not support deletes. Therefore, any data deleted in the Source may continue to exist in the Destination.

  • Hevo does not provide you with the option to select the historical sync duration for loading historical data. All the historical data in your ShipStation account is loaded.

Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Mar-05-2024 2.21 Updated the ingestion frequency table in the Data Replication section.
Oct-25-2022 2.00 New document.

Tell us what went wrong