Skip to main content

ShipStation Connector

ShipStation ShipStation is an e-commerce shipping and order fulfillment platform. This component allows you to manage orders, shipments, and carriers in ShipStation.

API Documentation

This component was built using the ShipStation API.

Connections

API Key

Authenticate using an API key and secret.

To authenticate with ShipStation, an API Key and API Secret are required.

Prerequisites

  • A ShipStation account with API access enabled

Setup Steps

  1. Navigate to the ShipStation account settings
  2. Navigate to the API Settings section
  3. Click Generate New Keys to create a new API Key and API Secret pair
  4. Copy both the API Key and API Secret values

Configure the Connection

Create a connection of type API Key and enter:

  • API Key: The API Key from the ShipStation account settings
  • API Secret: The API Secret from the ShipStation account settings

The API key must have the correct permissions to interact with the ShipStation API resources being accessed.

InputCommentsDefault
API KeyThe API key from the ShipStation account settings.
API SecretThe API secret from the ShipStation account settings.

Triggers

Manual Webhook

Receive and validate webhook requests from ShipStation for manually configured webhook subscriptions.

New and Updated Orders

Checks for new and updated orders in ShipStation on a configured schedule.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

New and Updated Products

Checks for new and updated products in ShipStation on a configured schedule.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

New and Updated Shipments

Checks for new and updated shipments in ShipStation on a configured schedule.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

Webhook Event Subscription

Receive webhook event notifications from ShipStation. Automatically creates and manages a webhook subscription for the selected event type when the instance is deployed, and removes the subscription when the instance is deleted.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Webhook EventThe event type to subscribe to for webhook notifications.
Store IDThe store ID to filter webhook triggers. When provided, webhooks will only trigger for this store.
Friendly NameA descriptive label to identify the webhook in the dashboard.

Actions

Create Label for Order

Creates a shipping label for a specified order.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Order IDThe unique identifier for the order.
Carrier CodeThe carrier code for the shipping label.
Service CodeThe shipping service code for the label.
ConfirmationThe delivery confirmation type (e.g., none, delivery, signature, adult_signature, direct_signature).
Ship DateThe date the order should be shipped in YYYY-MM-DD format.
Test LabelWhen true, creates a test label.false
Additional FieldsA list of additional fields to include in the label for order.

Create or Update Multiple Orders

Creates or updates multiple orders in one request.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Orders ArrayProvide an array of order objects to create or update multiple orders.
[
{
"orderNumber": "TEST-ORDER-001",
"orderDate": "2023-09-08T12:34:56.000Z",
"orderStatus": "awaiting_shipment",
"billTo": {
"name": "John Doe",
"street1": "123 Main St",
"city": "Anytown",
"state": "CA",
"postalCode": "12345",
"country": "US"
},
"shipTo": {
"name": "John Doe",
"street1": "123 Main St",
"city": "Anytown",
"state": "CA",
"postalCode": "12345",
"country": "US"
}
},
{
"orderNumber": "TEST-ORDER-002",
"orderDate": "2023-09-09T12:34:56.000Z",
"orderStatus": "awaiting_payment",
"billTo": {
"name": "Jane Doe",
"street1": "456 Another St",
"city": "Othertown",
"state": "NY",
"postalCode": "67890",
"country": "US"
},
"shipTo": {
"name": "Jane Doe",
"street1": "456 Another St",
"city": "Othertown",
"state": "NY",
"postalCode": "67890",
"country": "US"
}
}
]

Create or Update Order

Creates a new order or updates an existing one.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Order NumberThe user-defined order number to identify the order.
Order DateThe date the order was placed. Format: ISO 8601 (e.g., 2023-09-08T12:34:56.000Z).2023-09-08T12:34:56.000Z
Order StatusThe order status to filter results (e.g., awaiting_payment, awaiting_shipment, shipped).
Order KeyThe unique order key. If provided, the create order method will either create a new order if the key is not found, or update the existing order if found.
Billing AddressProvide the billing address in JSON format.
{
"name": "John Doe",
"company": "JD Company",
"street1": "123 Main St",
"city": "Austin",
"state": "TX",
"postalCode": "78701",
"country": "US",
"phone": "123-456-7890",
"residential": true
}
Shipping AddressProvide the shipping address in JSON format.
{
"name": "Jane Doe",
"company": "JD Company",
"street1": "123 Main St",
"city": "Austin",
"state": "TX",
"postalCode": "78701",
"country": "US",
"phone": "123-456-7890",
"residential": true
}
Additional FieldsA list of additional fields to include in the order.

Create Shipment Label

Creates a shipping label.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Carrier CodeThe carrier code for the shipping label.
Service CodeThe shipping service code for the label.
Package CodeThe package type code for the label.
Ship DateThe date the order should be shipped in YYYY-MM-DD format.
Shipment's WeightThe weight of the shipment, following the Weight model. Note: WeightUnits is read-only.
{
"value": 3,
"units": "ounces",
"WeightUnits": 2
}
Shipping AddressProvide the shipping address in JSON format.
{
"name": "Jane Doe",
"company": "JD Company",
"street1": "123 Main St",
"city": "Austin",
"state": "TX",
"postalCode": "78701",
"country": "US",
"phone": "123-456-7890",
"residential": true
}
Origin AddressProvide the origin address in JSON format.
{
"name": "John Smith",
"company": "JS Company",
"street1": "456 Elm St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94107",
"country": "US",
"phone": "987-654-3210",
"residential": false
}
Additional FieldsA list of additional fields to include in the shipment.

Create Warehouse

Creates a Ship From Location (warehouse) in the ShipStation account.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Warehouse NameA descriptive label for the ship-from location.
Origin AddressThe origin address. Shipping rates will be calculated from this address.
Return AddressThe return address. If not specified, the origin address will be used.
Is Default WarehouseWhen true, sets this as the default ship from location.false

Deactivate Store

Deactivates the specified store.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Store IDThe unique identifier for the store.

Delete Instanced Webhooks

Deletes all webhooks that point to a flow in this instance.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

Delete Order

Deletes an order from the database by setting it to inactive.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Order IDThe unique identifier for the order.

Delete Warehouse

Deletes a warehouse (Ship From Location) by setting it to inactive status.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Warehouse IDThe unique identifier for the warehouse.

Get Customer

Retrieves a specific customer by their system-generated identifier.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Customer IDThe unique identifier for the customer.

Get Order

Retrieves a single order from the database.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Order IDThe unique identifier for the order.

Get Product

Retrieves a specific product from the database by its ID.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Product IDThe unique identifier for the product.

Get Store

Retrieves detailed information about a specific store.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Store IDThe unique identifier for the store.

Get Warehouse

Retrieves detailed information about a specific Ship From Location (warehouse).

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Warehouse IDThe unique identifier for the warehouse.

List Carriers

Lists all shipping providers connected to the ShipStation account.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

List Customers

Retrieves a list of customers based on specified criteria.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
State CodeThe two-letter state or province abbreviation for the customer address.
Country CodeThe two-letter ISO country code to filter customers.
Marketplace IDThe unique identifier for the marketplace to filter results by.
Tag IDThe unique identifier for the tag to filter results by.
Sort ByThe API field name used to sort the returned results.
Sort DirectionThe direction to sort results (asc or desc).
PageThe page number to retrieve (starts at 1).
Page SizeThe maximum number of results to return per page. Maximum: 500.

List Fulfillments

Retrieves a list of fulfillments based on specified criteria.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Fulfillment IDThe unique identifier for the fulfillment.
Order IDThe unique identifier for the order.
PageThe page number to retrieve (starts at 1).
Page SizeThe maximum number of results to return per page. Maximum: 500.

List Orders

Retrieves a list of orders based on specified criteria.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Customer NameThe full name associated with the customer record.
Order StatusThe order status to filter results (e.g., awaiting_payment, awaiting_shipment, shipped).
PageThe page number to retrieve (starts at 1).
Page SizeThe maximum number of results to return per page. Maximum: 500.

List Packages

Retrieves a list of packages for the specified carrier.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Carrier CodeThe carrier code for the shipping label.

List Products

Retrieves a list of products that match the specified criteria.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
SKUThe stock keeping unit code assigned to the product.
Product NameThe display name of the product to search for.
Product Category IDThe unique identifier for the category grouping the product.
Product Type IDThe unique identifier for the product type classification.
Tag IDThe unique identifier for the tag to filter results by.
Start DateThe start date to filter products by creation date in YYYY-MM-DD format.
End DateThe end date to filter products by creation date in YYYY-MM-DD format.
Sort ByThe API field name used to sort the returned results.
Sort DirectionThe direction to sort results (asc or desc).
PageThe page number to retrieve (starts at 1).
Page SizeThe maximum number of results to return per page. Maximum: 500.
Show InactiveWhen true, includes inactive stores in the results.false

List Services

Retrieves the list of available shipping services for the specified carrier.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Carrier CodeThe carrier code for the shipping label.

List Shipments

Retrieves a list of shipments that match the specified criteria.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Tracking NumberThe carrier-assigned tracking number for the shipment.
Create Date StartThe start date to filter shipments by creation date in YYYY-MM-DD format.
Create Date EndThe end date to filter shipments by creation date in YYYY-MM-DD format.
Ship Date StartThe start date to filter shipments by ship date in YYYY-MM-DD format.
Ship Date EndThe end date to filter shipments by ship date in YYYY-MM-DD format.
Recipient NameThe name of the person or business receiving the shipment.
Recipient Country CodeThe two-letter ISO country code to filter shipments by recipient country.
PageThe page number to retrieve (starts at 1).
Page SizeThe maximum number of results to return per page. Maximum: 500.

List Stores

Retrieves the list of installed stores on the account.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Show InactiveWhen true, includes inactive stores in the results.false
Marketplace IDThe marketplace ID to filter stores.

List Users

Retrieves the list of users on the account.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Show Inactive UsersWhen true, includes inactive users in the results.false

List Warehouses

Retrieves a list of Ship From Locations (warehouses) in the account.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

List Webhooks

Retrieves a list of registered webhooks for the account.

InputCommentsDefault
ConnectionThe ShipStation connection to use.

Raw Request

Sends a raw HTTP request to the ShipStation API.

InputCommentsDefault
URLThis is the URL to call.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Retry Delay (ms)The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.false
Max Retry CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.false
ConnectionThe ShipStation connection to use.

Subscribe to Webhook

Subscribes to a specific type of webhook in ShipStation.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Target URLThe URL where webhook events will be sent.
EventThe webhook event type to subscribe to.
Store IDThe store ID to filter webhook triggers. When provided, webhooks will only trigger for this store.
Friendly NameA descriptive label to identify the webhook in the dashboard.

Unsubscribe from Webhook

Unsubscribes from a specific type of webhook in ShipStation.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Webhook IDThe unique identifier for the webhook.

Update Product

Updates an existing product.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Product IDThe unique identifier for the product.
Product DataThe complete data for updating the product. This call does not support partial updates.
{
"aliases": null,
"productId": 123456789,
"sku": "BEAU-000"
}

Update Store

Updates an existing store.

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Store IDThe unique identifier for the store.
Store Update DataAll the data needed to update an existing store. Must provide the entire resource.
{
"storeId": 12345,
"storeName": "WooCommerce Store",
"marketplaceId": 36
}

Update Warehouse

Updates an existing Ship From Location (warehouse).

InputCommentsDefault
ConnectionThe ShipStation connection to use.
Warehouse Update DataAll the data needed to update an existing Ship From Location. Must provide the entire resource.
{
"warehouseId": 12345,
"warehouseName": "API Ship From Location"
}