> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/shipping-services/legacy-shipstation-upgrading-to-the-new-integration.md).

# Legacy ShipStation – Upgrading to the New Integration

In August 2017, we released a new ShipStation integration that is more reliable and provides more options than the legacy ShipStation integration did. This guide will go over how to phase out the legacy integration on your account and begin to use the new integration.

If you enabled ShipStation before August 2017, you should switch to the new integration at your earliest convenience. If you are unsure which integration you are using, look at the ShipStation logo on your Manage Integrations page or in the top right corner of the ShipStation integration settings page. The old integration will say Legacy:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FgG1WpybsTdg7rJJsW67k%2Flegacy-9c534fbdb993ae91d206.png?alt=media)

### Prepare to Disable Legacy Integration

**Caution!** If you have any unshipped orders that have already been sent to the legacy ShipStation integration, do not disable it yet. Follow these instructions to finish shipping orders that were sent to ShipStation through the legacy integration and begin using the new integration moving forward. Both integrations can be enabled at the same time so you can switch to the new integration without pausing your fulfillment. If you have completed all shipments for the old integration, you can safely disable the old integration in Order Desk but you should also disable it or turn off the auto-update in ShipStation as well. This guide will cover these steps.

Navigate to the legacy ShipStation settings page in Order Desk:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FHzJBr3VFproS2utiaPS1%2Flegacy-1bd2b1462ff93f5382a5.png?alt=media)

Set the **Import Date Override** time to 2020-01-01:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fq1d82ar9xKjEs1n9y0jm%2Flegacy-83306cd7adc2c8361875.png?alt=media)

By putting in this future date, you will be preventing ShipStation from downloading any more orders, but it will allow you to keep the integration enabled until all of the orders already there have shipped and had their shipment details sent back to Order Desk.

Next, you’ll need to login to your [ShipStation account](https://ss.shipstation.com/) directly to prevent it from pulling orders from Order Desk automatically. Click on the **Gear Icon** in the upper right corner:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FvTMinf6iNpGxc26ObPl6%2Flegacy-8d59a2e0fa3947efa114.png?alt=media)

In the left sidebar, click on **Selling Channels** then **Store Setup**:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FZrKP1GJ9DYfEp96pcytS%2Flegacy-5c37ab4b73a5be1cb889.png?alt=media)

Find the store that is connected to Order Desk and click on **Edit**:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FTg4rQ1ijCzlvF2G5GP1s%2Flegacy-39fa1a6c604a7dd6e82d.png?alt=media)

Make sure that the **Allow this store to ‘auto-update’ periodically?** setting is ***disabled*** to prevent ShipStation from pulling in any more orders from Order Desk:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FHrKZ7um8nbn5ECqBq7oY%2Flegacy-6bba908ec8751d09fc27.png?alt=media)

### Create a Manual Store at ShipStation

Now that the legacy integration will stop sending orders to ShipStation and ShipStation will stop pulling orders from Order Desk, you can set up a new manual store in ShipStation to connect to the new integration. While you’re still in ShipStation, click on the green **Connect a Store or Marketplace** button:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F1wwFjjZFUc9vzuVdb6YI%2Flegacy-385e7016e5d83fd67f26.png?alt=media)

Scroll through the options and find the ShipStation button or type ShipStation into the **S** **earch by Name** field and click this ShipStation button:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FE3SZwXgZ8FrmxiHxa2Nd%2Flegacy-c8cec47015bc3d8df553.png?alt=media)

Give your new manual store a unique name so it is easily identifiable, adjust the settings and click **Connect**:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FYLGso4HSzL5WgBkZesH2%2Flegacy-f97ec749c6fdeafa59e6.png?alt=media)

On the next page, you will have a few more settings to choose from. On this new store, you can leave the **Allow this store to ‘auto-update’ periodically?** setting enabled. Then save your new store, which will now appear in your list of ShipStation stores:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FkvJjh3KUuBuyyRHFo47e%2Flegacy-c9322c913905d5c4c814.png?alt=media)

### Enable the New Integration

Now that you have a new manual store to connect to in ShipStation, you can enable the new integration. To do this, head back into Order Desk and click on **Manage Integrations** in the left sidebar:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F9FYxLbceD2bqenkZJ8ce%2Flegacy-b6fce4a81ea3a983eb2f.png?alt=media)

Click the **Shipping** tab and enable ShipStation. The ShipStation you see under the Shipping tab will be the new integration, as the legacy integration is no longer accessible from this tab:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FB7XaqMl9xym8bTmYzr9L%2Flegacy-bfd0ad8d5c8c1a8db2ae.png?alt=media)

You’ll need to head back over to your ShipStation account to get your API Key and API Secret. To find these in ShipStation, click on the **Gear Icon** in the upper right corner, then in the left sidebar click on **Account** and then **API Settings**:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FEYY2nmeUgvJkPDDxLqGm%2Flegacy-d20d046a6e07a06cd8a9.png?alt=media)

If you haven’t already, click on the green **Generate New API Keys** button:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F49peNFvIl82y7vyM8zUG%2Flegacy-592374c0eab775de699a.png?alt=media)

You will need to copy both the API Key and API Secret:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FZxmu3FMVjoy85NcXiIBY%2Flegacy-2e8b974398bedc59262a.png?alt=media)

Bring each of these back into Order Desk, copy them into the ShipStation integration settings and click **Connect**:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FPWu8OgoJ784XHAqJIxJE%2Flegacy-b2db164453fb2f4d4631.png?alt=media)

You have now successfully connected to the new ShipStation integration and can begin to send your orders to ShipStation. For instructions on how to use the new integration, please continue on to our [new ShipStation Settings and Features guide](/integration-setup-guides/shipping-services/shipstation-integration-settings-and-features.md).

### Disable the Legacy Integration

Once all orders that had already been sent to ShipStation through the legacy integration have been sent back to Order Desk, you can disable the integration. To do this, click on **Manage Integrations** in the left sidebar under the **Integrations** menu:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FDTjm19ygo1p0BZs71faW%2Flegacy-4726e0d3f4a12ba2be35.png?alt=media)

Click on **Disable** for the ShipStation Legacy integration:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FPvlYxRh135w4T3VajUZo%2Flegacy-d9012d76e768d696580e.png?alt=media)

Once disabled, you will not be able to re-enable this integration, so be certain all orders have been sent back to Order Desk first.

### Related Articles

* ShipStation: Integration Settings and Features
* Legacy ShipStation – Setup
* Legacy ShipStation – Setting up a Custom Store


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.orderdesk.com/integration-setup-guides/shipping-services/legacy-shipstation-upgrading-to-the-new-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.