Raw data only. ShipStation lands as raw warehouse tables, not modeled dashboards or AI analysis. Raw tables are delivered only to organizations on a dedicated warehouse, for the tables picked under Warehouse → Raw data in your SourceMedium workspace. See Foundation and Pro.
Sign in to SourceMedium, open your store, then choose Data sources → Connect data source and select the platform. You need an Admin or Editor workspace role.After you connect explains the first sync and connection statuses.
Vendor documentation
Requirements
- A ShipStation Standard or Premium plan. Free and Starter plans include no API access. On those plans, ShipStation accepts the key but will not serve shipments, and the connection says so. Reconnecting does not fix this.
- Your account’s ShipStation V2 API key. The V1 API key and secret, from ShipStation’s legacy API, do not work.
- Full-access key, read-only use. A V2 key has full account access, including buying and voiding labels. SourceMedium only reads: it lists shipments, labels, carriers, and warehouses, and never creates, buys, or voids anything.
How to connect
1
Get your V2 API key
Open ShipStation’s API Settings page. If your account already has a V2 key, use that key. If it has none, click Generate API Key in the V2 section and copy the key.
2
Add the key in SourceMedium
Find ShipStation in the connector picker and click Connect. Paste the V2 API key, then click Save.
3
Confirm it is connected
SourceMedium checks the key with ShipStation before saving it, so a V1 key, or a V2 key that has since been replaced, is rejected on the spot. The connection reads Awaiting first data until the first sync lands, then Connected.
SourceMedium only ever reads from your connected platforms. It does not create, change, or delete anything, so create the key with read-only access wherever the platform offers it. Treat it like a password: keep it confidential and avoid sharing it over email or in spreadsheets. If the credential is rotated or revoked, follow this guide’s connection method to update SourceMedium.
What data syncs
Labels carry their status, void state (
voided, voided_at), refund details, tracking number, your external order and shipment IDs, and their shipment and insurance costs, each as an amount column and a currency column. ShipStation’s V2 API has no separate sales-order object: a V2 shipment roughly corresponds to a V1 order.
Recipient addresses keep only the country, the state or province, and the residential flag. Recipient names, companies, emails, phone numbers, street lines, cities, postal codes, geolocation, delivery instructions, buyer notes, customs tax identifiers, and label download links are not imported. Your own ship-from and warehouse addresses are kept, except on return shipments, where the sender is the shopper and the address is reduced the same way.
Select the tables you want under Warehouse → Raw data in your SourceMedium workspace to receive them in your_project.sm_sources.
Refresh and history
- Refresh: every six hours. Shipments are read by the time they were last modified, so changed shipments are updated. Carriers and warehouses are read in full on every sync.
- Labels: ShipStation offers no way to ask for labels that changed, so each sync re-reads every label created in the last 30 days, which picks up voids and refunds.
- History: the first sync loads 365 days of shipments and labels. Your other ShipStation integrations share the same key’s rate limit, so SourceMedium reads at most 30 requests a minute, and a busy account’s first sync can take a while.
Known gaps
- Late voids and refunds. A label voided or refunded more than 30 days after it was created keeps its earlier state.
- Not included: inventory, products, and fulfillments.
Troubleshooting
- Key rejected? Check that it is the V2 key, not the V1 key and secret, and that nobody has generated a newer V2 key since. A newer key replaces the old one, which then stops working everywhere.