ShipStation

ShipStation is a shipping software for e-commerce order fulfillment.

Overview

The ShipStation connector lets Spojit workflows read and write orders, generate shipping labels, fetch rates across carriers, and pull warehouse and customer data. It's the bridge between your storefront and your carrier accounts when ShipStation is the fulfillment hub.

Use it to auto-fulfill orders from Shopify, WooCommerce, or BigCommerce, to route orders to the cheapest carrier by destination, and to keep a running stream of shipment data flowing into your reporting or finance systems.

What You Can Do

The ShipStation connector exposes these tools:

list-orders / get-order - Read orders, with filters for status, store, and date range.
create-order - Create an order in ShipStation (typically from an upstream storefront event).
create-shipment-label - Buy and generate a shipping label for a specified order, service, and package.
void-label - Cancel an unused label and refund the carrier charge.
get-rates - Quote rates across configured carriers for a given destination and package.
list-shipments - List historical shipments with tracking numbers and statuses.
list-carriers - List the carrier accounts configured in ShipStation.
list-warehouses - List the ship-from warehouses configured in ShipStation.
list-customers / list-products - Read customer and product reference data.
raw-api-request - Escape hatch for endpoints not covered by the dedicated tools.

Authentication

ShipStation uses an API key + API secret pair. In ShipStation, go to Account Settings -> API Settings and generate (or copy) the key and secret. Both values are needed when creating the connection in Spojit. The connector signs each request with Basic auth.

Setting Up Your Connection

Generate the API key and secret in ShipStation's Account Settings.
In Spojit, go to Connections and click + Add Connection.
Search for ShipStation and select it.
Paste the API key and API secret.
Name the connection descriptively (e.g. ShipStation - Production).
Click Save. Spojit verifies the credentials and marks the connection Active.

Using in a Workflow

Add a Connector node, pick the ShipStation connection, and use Direct Mode for deterministic operations (auto-fulfill on order webhook, rate-quote on cart event, void-label on customer cancellation). Agent Mode is useful for ad-hoc operator tooling - "find this customer's last shipment and email the tracking link" type prompts.

Tips

Always call get-rates before create-shipment-label if you have multiple carriers configured - it lets you route to the cheapest option per destination.
Stamp the source storefront's order ID into ShipStation's orderNumber so reporting can join the two systems.
Use list-shipments with a date filter for daily reporting rather than walking individual orders.
Void unused labels on order cancellation - ShipStation only refunds within a carrier-specific window (often 14-30 days).

Common Pitfalls

Rate limits - ShipStation enforces 40 requests per minute. Burst calls during bulk fulfillment will trip rate limiting; batch with a small delay.
International addresses - Many carriers require declared customs values and tariff codes. create-shipment-label rejects international labels missing these.
Warehouse selection - The default ship-from warehouse may not match the actual stock location for split-shipment orders. Set it explicitly per call.
Test vs production - ShipStation does not have a sandbox; use a dev carrier account or run with very small label values during testing.

Common Use Cases

For technical API details and field specifications, see the ShipStation connector documentation.