Shippo

Shippo is a shipping and fulfillment platform for generating labels, comparing carrier rates, tracking packages, and managing multi-carrier shipping operations. This integration uses managed OAuth through ClawLink to automate your entire shipping workflow without managing API keys.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Shippo
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Shippo

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   Shippo API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

Get live shipping rates for a package:

clawlink_execute_tool --integration shippo --tool shippo_create_live_rate --args '{"address_from": "addr-123", "address_to": "addr-456", "parcels": [{"length": "10", "width": "8", "height": "6", "distance_unit": "in", "weight": "2", "mass_unit": "lb"}]}'

Create a shipment and get rates:

clawlink_execute_tool --integration shippo --tool shippo_create_shipment --args '{"address_from": "addr-123", "address_to": "addr-456", "parcels": ["parcel-789"]}'

Track a package:

clawlink_execute_tool --integration shippo --tool shippo_get_track --args '{"carrier": "usps", "tracking_number": "9400111899223100001234"}'

Authentication

Shippo uses OAuth 2.0 managed by ClawLink. No API keys are needed. Authorize access through the ClawLink dashboard. Your Shippo connection is stored securely and refreshed automatically.

Connect at: https://claw-link.dev/dashboard?add=shippo

Connection Management

List connections:

clawlink_list_integrations

Verify connection:

clawlink_execute_tool --integration shippo --tool shippo_list_carrier_accounts

Reconnect: If a connection expires, visit the dashboard URL above and reconnect Shippo.

Security & Permissions

• Read operations (retrieving addresses, shipments, rates, tracking, orders, transactions) are safe and require no confirmation.
• Write operations (creating addresses, shipments, orders, transactions, labels, batches, webhooks, parcels) modify data and require confirmation.
• Destructive operations (deleting webhooks, parcel templates, removing shipments from batches) are high-impact and require explicit confirmation.

Tool Reference

Address Operations

Shipment Operations

Rate & Live Rate Operations

Transaction (Label) Operations

Order Operations

Parcel Operations

Tracking Operations

Batch Operations

Carrier Account Operations

Customs Operations

Manifest Operations

Refund Operations

Parcel Template Operations

Service Group Operations

Webhook Operations

Account Operations

Merchant Operations (Platform API)

Code Examples

Create a shipment and get rates:

{
  "tool": "shippo_create_shipment",
  "args": {
    "address_from": "addr-uuid-from",
    "address_to": "addr-uuid-to",
    "parcels": ["parcel-uuid"],
    "async": false
  }
}

Purchase a shipping label:

{
  "tool": "shippo_create_transaction",
  "args": {
    "rate": "rate-uuid",
    "label_file_type": "PDF",
    "async": false
  }
}

Track a package:

{
  "tool": "shippo_get_track",
  "args": {
    "carrier": "usps",
    "tracking_number": "9400111899223100001234"
  }
}

Create an address:

{
  "tool": "shippo_create_address",
  "args": {
    "name": "Jane Smith",
    "street1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US",
    "validate": true
  }
}

List carrier accounts:

{
  "tool": "shippo_list_carrier_accounts",
  "args": {}
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm shippo is connected.
2. Call clawlink_list_tools --integration shippo to see the live catalog.
3. Start with shippo_list_carrier_accounts to see available carriers.
4. Use shippo_list_addresses to browse stored addresses.
5. Use shippo_list_shipments to view existing shipments.

Execution Workflow

Read Flow:
  list_addresses → create_shipment → list_shipment_rates → get_rate

Label Flow:
  create_shipment → list_shipment_rates → create_transaction (confirm) → get_track

Track Flow:
  get_track → (carrier + tracking_number) → tracking status + history

Order Flow:
  create_order → create_shipment → create_transaction (confirm)

Notes

• Shippo supports both direct API operations and Platform API (merchant) operations for multi-tenant scenarios.
• Batch operations require a valid carrier account ID. Batches must be in VALID status before purchasing.
• UPS carrier account creation requires agreeing to UPS terms and conditions.
• Customs declarations and items are required for international shipments.
• The create_live_rate tool provides real-time pricing from multiple carriers in a single call.

Error Handling

Troubleshooting

Tools Not Visible

Run clawlink_list_tools --integration shippo to verify the integration is active. If empty, reconnect at https://claw-link.dev/dashboard?add=shippo.

Rate Not Found

Ensure you have created a shipment first and have the shipment ID. Rates are generated per shipment.

Label Purchase Fails

Verify the rate ID is valid and has not expired. Rates are typically valid for a limited time after generation.

Address Validation Fails

Check that all required fields (street, city, state, zip, country) are provided and correctly formatted.

Resources

• Shippo API Docs: https://docs.goshippo.com
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=shippo
• ClawLink Docs: https://docs.claw-link.dev/openclaw

Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=shippo) -- an integration hub for OpenClaw