Advanced Analytica Advanced Analytica: IBOM
← All connectors
Shipstation logo

Source connector

Shipstation

Set up Shipstation as a source and move its data into your chosen destination.

Version 0.3.0 community alpha

ShipStation

The ShipStation source connector reads data from the ShipStation V1 API at https://ssapi.shipstation.com/.

Before you begin

  • A ShipStation account with V1 API access. See ShipStation’s API subscription requirements for eligible plans.
  • A V1 API key and API secret. Only the ShipStation account owner can generate these credentials. Email verification is required. V2 API keys aren’t interchangeable with V1 credentials.

Set up the connector

Get your API credentials

Use your valid V1 API key and secret if you’ve stored them securely. Otherwise, follow ShipStation’s API key instructions:

  1. Sign in as the ShipStation account owner and open Settings > Account > API Settings.
  2. Select V1 from the API version dropdown and click Generate API Key.
  3. Complete the email verification, then return to generate the key.
  4. Choose an expiration period and click Generate.
  5. Copy the API key and API secret, then store them securely. ShipStation displays them only once, immediately after generation.

Generate a replacement pair before your credentials expire, then update the source in Airbyte. See ShipStation’s key rotation instructions for details.

Configure the Airbyte source

Create a ShipStation source and enter these values:

InputField in AirbyteDescription
usernameAPI KeyYour ShipStation V1 API key, used as the HTTP Basic authentication username.
passwordAPI SecretThe matching V1 API secret, used as the HTTP Basic authentication password.
start_dateStart dateRequired. The starting timestamp for orders, shipments, and fulfillments, in the format YYYY-MM-DDTHH:mm:ssZ, for example 2026-01-01T00:00:00Z. No default value.

Supported streams and sync modes

All streams support full refresh. Only orders, shipments, and fulfillments support incremental sync.

StreamDataPrimary keyIncremental cursor
carriersShipping providers connected to your accountshippingProviderIdNot supported
carrier_packagesPackage types available for each connected carriercarrierCode, codeNot supported
carrier_servicesShipping services available for each connected carriercarrierCode, code, domestic, internationalNot supported
customersCustomer recordscustomerIdNot supported
fulfillmentsFulfillment records, including orders marked as shipped through the UI or APIfulfillmentIdcreateDate
ordersOrdersorderIdmodifyDate
productsProduct recordsproductIdNot supported
shipmentsShipments with labels generated in ShipStation, including shipment itemsshipmentIdcreateDate
marketplacesSupported marketplacesname, marketplaceIdNot supported
storesStores, including inactive storesstoreIdNot supported
tagsTags defined for your accounttagIdNot supported
usersUsers, including inactive usersuserIdNot supported
warehousesShip From locationswarehouseIdNot supported
webhooksRegistered webhook configurationsWebHookIDNot supported

The carrier_packages and carrier_services streams read the carrier list. They then request packages or services for each distinct carrier code. You don’t need to enter carrier codes manually.

Incremental sync behaviour

  • orders uses modifyDate to retrieve new and updated orders from the configured start date.
  • shipments and fulfillments use createDate. Incremental sync doesn’t capture changes to records created before the saved cursor’s lookback window. Use a full refresh to retrieve those changes. Set a start date early enough to include the records.
  • All three incremental streams use a six-hour lookback window. Later syncs can therefore emit records that were already read.

ShipStation’s V1 API timestamps use Pacific Time (PST/PDT).

Shipment coverage

The shipments endpoint returns only shipments with labels generated in ShipStation. Orders marked as shipped through the UI or API are treated as external shipments. They’re available from the fulfillments endpoint.

The webhooks stream reads webhook configurations. It doesn’t receive webhook events.

Rate limits and troubleshooting

ShipStation’s V1 API rate limit is 40 requests per minute for each API key and secret pair. Other applications using the same credentials share this limit. When rate limited, the connector waits according to the X-Rate-Limit-Reset response header.

  • 401 Unauthorized: Check that the API key and secret are a matching, unexpired V1 pair.
  • 402 response: Check that your ShipStation plan includes V1 API access.
  • 429 Too Many Requests: If throttling continues, reduce overlapping API activity that uses the same credentials.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.3.02026-11-1191538Add tags, carrier_packages and carrier_services streams, declare additional orders, products and fulfillments fields, and set heartbeat and suggested-streams metadata
0.2.542026-11-1091707Update dependencies
0.2.532026-11-0490360Simplify rate-limit error handling configuration with no change in retry behavior
0.2.522026-11-0390739Update dependencies
0.2.512026-10-2089386Update dependencies
0.2.502026-10-1388800Update dependencies
0.2.492026-10-0688037Update dependencies
0.2.482026-09-2987343Update dependencies
0.2.472026-09-2286788Update dependencies
0.2.462026-09-1586217Update dependencies
0.2.452026-09-0885663Update dependencies
0.2.442026-08-1884755Update dependencies
0.2.432026-08-1184092Update dependencies
0.2.422026-08-0483616Update dependencies
0.2.412026-07-2883075Update dependencies
0.2.402026-07-2182571Update dependencies
0.2.392026-07-1482005Update dependencies
0.2.382026-06-3081250Update dependencies
0.2.372026-06-2380626Update dependencies
0.2.362026-06-1680018Update dependencies
0.2.352026-06-0979471Update dependencies
0.2.342026-06-0278974Update dependencies
0.2.332026-04-2877448Update dependencies
0.2.322026-04-2175332Update dependencies
0.2.312026-03-1074592Update dependencies
0.2.302026-02-2473945Update dependencies
0.2.292026-02-1773523Update dependencies
0.2.282026-02-1073202Update dependencies
0.2.272026-02-0372729Update dependencies
0.2.262026-01-2072120Update dependencies
0.2.252026-01-1471622Update dependencies
0.2.242025-12-1870674Update dependencies
0.2.232025-11-2570104Update dependencies
0.2.222025-11-1869458Update dependencies
0.2.212025-10-2968802Update dependencies
0.2.202025-10-2168230Update dependencies
0.2.192025-10-1467777Update dependencies
0.2.182025-10-0767430Update dependencies
0.2.172025-09-3066910Update dependencies
0.2.162025-09-2466256Update dependencies
0.2.152025-09-0965722Update dependencies
0.2.142025-08-2465449Update dependencies
0.2.132025-08-1664998Update dependencies
0.2.122025-08-0364478Update dependencies
0.2.112025-07-1963634Update dependencies
0.2.102025-07-0562735Update dependencies
0.2.92025-06-2862253Update dependencies
0.2.82025-06-1461308Update dependencies
0.2.72025-05-2460504Update dependencies
0.2.62025-05-1060142Update dependencies
0.2.52025-05-0459604Update dependencies
0.2.42025-04-2759020Update dependencies
0.2.32025-04-1957453Update dependencies
0.2.22025-03-2956874Update dependencies
0.2.12025-03-2256257Update dependencies
0.2.02025-03-1355738add incremental for orders, shipments and fullfillments
0.1.52025-03-0955648Update dependencies
0.1.42025-03-0155122Update dependencies
0.1.32025-02-2254511Update dependencies
0.1.22025-02-1554047Update dependencies
0.1.12025-02-0853551Update dependencies
0.1.02025-02-0352707Change auth method
0.0.62025-02-0153109Update dependencies
0.0.52025-01-2552405Update dependencies
0.0.42025-01-1851911Update dependencies
0.0.32025-01-1151328Update dependencies
0.0.22024-12-2850726Update dependencies
0.0.12024-12-21Initial release by @JohnnyRafael via Connector Builder
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.