Skip to content

ShipStation V1 API (Legacy) (1.0.0)

The ShipStation V1 API (Legacy) provides comprehensive functionality for managing orders, shipments, carriers, and more within the ShipStation platform.

Getting Started

New integrations should use ShipStation API V2 whenever possible. This V1 API is maintained for existing integrations.

Download OpenAPI description
Languages
Servers
Mock server
https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/
Production Server
https://ssapi.shipstation.com/

Accounts

Account management and tag operations

Operations

Carriers

Carrier information and package/service listings

Operations

Customers

Customer management

Operations

Fulfillments

Fulfillment operations

Operations

Orders

Order management and operations

Operations

Products

Product catalog management

Operations

Shipments

Shipment operations and rate shopping

Operations

Stores

Store configuration and management

Operations

Users

User management

Operations

Warehouses

Warehouse and fulfillment location management

Operations

Webhooks

Webhook subscription management

Operations

List webhooks

Request

Retrieves a list of registered webhooks for the account

Security
basicAuth
curl -i -X GET \
  -u <username>:<password> \
  https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/webhooks

Responses

List of webhooks retrieved successfully

Bodyapplication/json
webhooksArray of objects
Response
application/json
{ "webhooks": [ {} ] }

Subscribe to webhook

Request

Subscribes to a specific type of webhook. If a store_id is passed in, the webhooks will only be triggered for that specific store_id.

Note: Webhooks can only be modified through the ShipStation UI under Account Settings.

Security
basicAuth
Bodyapplication/jsonrequired
target_urlstringrequired

The URL to send the webhooks to

Example: "http://someexamplewebhookurl.com/neworder"
eventstringrequired

The type of webhook to subscribe to

Enum"ORDER_NOTIFY""ITEM_ORDER_NOTIFY""SHIP_NOTIFY""ITEM_SHIP_NOTIFY""FULFILLMENT_SHIPPED""FULFILLMENT_REJECTED"
Example: "ORDER_NOTIFY"
store_idinteger or null

Store ID (optional - webhooks will only trigger for this store)

Example: 12345
Any of:

Store ID (optional - webhooks will only trigger for this store)

integer
friendly_namestring

Display name for the webhook

Example: "My Webhook"
curl -i -X POST \
  -u <username>:<password> \
  https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/webhooks/subscribe \
  -H 'Content-Type: application/json' \
  -d '{
    "target_url": "http://someexamplewebhookurl.com/neworder",
    "event": "ORDER_NOTIFY",
    "store_id": 12345,
    "friendly_name": "My Webhook"
  }'

Responses

Webhook subscription created successfully

Bodyapplication/json
WebHookIDinteger
Example: 123456
HookTypestring
Urlstring
Namestring
Response
application/json
{ "WebHookID": 123456, "HookType": "string", "Url": "string", "Name": "string" }

Unsubscribe from webhook

Request

Unsubscribes from a certain webhook

Security
basicAuth
Path
webhookIdintegerrequired

A unique ID generated by ShipStation and assigned to each webhook

Example: 123456
curl -i -X DELETE \
  -u <username>:<password> \
  https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/webhooks/123456

Responses

Webhook unsubscribed successfully

Bodyapplication/json
successboolean
Example: true
messagestring
Example: "Webhook deleted successfully"
Response
application/json
{ "success": true, "message": "Webhook deleted successfully" }