Skip to main content

​
Overview

Phinite’s ShipStation predefined tool lets workspace assistants call ShipStation APIs through DevStudio after you save a connection under Integrations → Predefined tools. Manage ShipStation shipping and fulfillment — orders, shipments and labels, carriers, products, customers, warehouses, stores, and fulfillments via the ShipStation V1 API.
Predefined tools require a saved connection before they appear in Graph Studio’s tool picker. See Predefined Tools in GraphStudio.

​
What this integration enables

  • Automate workflows using this predefined tool from agent graphs
  • Connect once under Integrations and reuse across assistants
  • Enable individual subtools per agent in Graph Studio

​
Required credentials

  • API Key api_key (required)
  • API Secret api_secret (required)

​
Setup steps

  1. In ShipStation go to Account → API Settings and generate API Key and API Secret.
  2. Log into your Phinite workspace at app.phinite.ai
  3. Navigate to Integrations → Predefined tools
  4. Select ShipStation
  5. Click + Add Configuration
  6. Enter the credential fields listed above
  7. Select assistants that should use this connection
  8. Click Save Configuration

​
Configure in Graph Studio

  1. Open an agent in Graph Studio
  2. Select the agent node → Tools tab → Add a new tool
  3. Choose ShipStationTool (or search for ShipStation)
  4. Select your saved connection or add a new one
  5. Enable the subtools your workflow needs and save

​
Predefined tools

Phinite provides 28 subtools for ShipStation:
  • List Orders: Lists orders with optional filters and pagination.
  • Get Order: Gets a single order by ID.
  • Create Order: Creates or updates a single order (upsert keyed on orderKey).
  • Create Orders: Creates or updates multiple orders in one call (max 100).
  • Delete Order: Deletes (deactivates) an order by ID.
  • Mark As Shipped: Marks an order as shipped without creating a label.
  • Add Tag: Adds a tag to an order.
  • Remove Tag: Removes a tag from an order.
  • Hold Until: Holds an order until a specified date.
  • Restore From Hold: Restores an order from hold back to awaiting shipment.
  • Assign User: Assigns a user to one or more orders.
  • List By Tag: Lists orders that have a specific tag and status.
  • List Shipments: Lists shipments (ShipStation-generated labels) with optional filters.
  • Create Label For Order: Creates a shipping label for an existing order. Returns a base64 PDF in labelData.
  • Create Label: Creates a shipping label without an order. Returns a base64 PDF in labelData.
  • Void Label: Voids a previously created shipping label.
  • Get Rates: Gets shipping rate quotes for a shipment.
  • List Carriers: Lists carriers connected to the account.
  • List Packages: Lists package types available for a carrier.
  • List Services: Lists shipping services available for a carrier.
  • List Products: Lists products with optional filters.
  • Get Product: Gets a single product by ID.
  • Update Product: Updates a product (full-resource PUT — include all fields).
  • List Customers: Lists customers with optional filters.
  • Get Customer: Gets a single customer by ID.
  • List Warehouses: Lists warehouses (ship-from locations).
  • List Stores: Lists stores (sales channels).
  • List Fulfillments: Lists fulfillments (externally fulfilled shipments) with optional filters.

​
Documentation & resources

  • Official documentation: https://www.shipstation.com/docs/api/
  • Phinite documentation: ShipStation

​
Notes

  • Store API keys and tokens securely; many providers show secrets only once
  • Use separate connections for Dev, UAT, and Prod environments where possible
  • Test with a minimal subtool call after saving credentials