This article covers generating an API Key in ShipStation and connecting it to your ShipStation integration in Acenda, plus how to tell when your keys are missing or invalid and how to fix it.
Before you start: This article assumes you already have a ShipStation integration in Acenda. If you're setting one up for the first time, start with the Acenda and ShipStation Integration: Step-by-Step Guide. For a general overview of fulfillment providers, see Integrating Fulfillment Providers: A Complete Guide.
Generate an API Key in ShipStation
Log in to your ShipStation account and click the gear icon in the top right to open Settings.
In the left sidebar, expand Account and select API Settings.
Under Select API Version, choose V1 API. Acenda's ShipStation integration uses the V1 API, not V2.
Click Generate API Key.
Choose a key expiration: 3 months, 6 months, or 12 months. We recommend 12 months, with a calendar reminder to regenerate the key before it expires.
Click Generate. ShipStation shows your new API Key and Secret Key once. Copy both now and store them securely — ShipStation won't show the secret again, and if you lose it you'll need to generate a new set.
Add the key to your ShipStation integration in Acenda
In the sidebar, under CHANNELS, click Integrations.
Find ShipStation under Fulfillment Providers and click Edit (or + New if you haven't added it yet).
Open the Settings tab, then the Authorization tab.
Paste the API Key and API Secret ShipStation just generated for you into the matching fields.
Click Save.
Note: This Key/Secret pair is for ShipStation's V1 API. If your account is instead set up for ShipStation's newer V2 API, the Authorization tab will show different fields. Contact Acenda Support if you're not sure which one your integration uses.
What happens if your keys are missing or invalid
If the API Key or Secret saved in Acenda is missing, mistyped, or no longer valid in ShipStation — including when a key simply expires — new orders stop flowing to ShipStation and tracking updates stop coming back into Acenda. Acenda doesn't send you an advance warning before a key expires, which is why the calendar reminder above matters.
Confirm your connection is healthy
In ShipStation: the API Settings page lists each key's Created Date and Expiration. A key past its expiration date is no longer valid.
In Acenda: go to CHANNELS > Integrations. If the ShipStation connection is unhealthy, you'll see a red warning icon next to it — hover over it and it reads Connection Unhealthy. Click Edit to open the integration and update your keys.
After you save new keys, give it until Acenda's next sync with ShipStation to clear. The red icon and the Connection Unhealthy message should go away on their own once that happens — you don't need to do anything else.
Troubleshooting
Still unhealthy right after saving: Give it a little time for the next sync between Acenda and ShipStation. It doesn't update instantly.
Generated a new key in ShipStation, but Acenda still shows unhealthy: Regenerating a key in ShipStation doesn't update Acenda automatically. You still need to paste the new API Key and Secret into the Authorization tab in Acenda and click Save.
Pasted the key and it's still failing: Check for an extra space before or after the value, and make sure the API Key and API Secret weren't swapped between fields.
Generated a V2 key instead of V1: Make sure Select API Version was set to V1 API before you clicked Generate. A V2 key won't work in the Authorization fields this article covers.
Only some ShipStation activity is failing (for example, orders aren't importing) while everything else looks fine: This can mean the API key is valid but missing a permission in ShipStation, rather than being invalid. Contact Acenda Support so we can confirm which permission is missing.
Related articles
Still stuck? Contact Acenda Support and let us know your subscription ID or integration name.