Shippo · Live

Ask Shippo where a parcel really is.

Read Shippo shipments, transactions, and tracking events so the agent can audit shipping costs and answer delivery-status questions.

Auth
API key
Access
Read-only by default
Plan
Every plan
Freshness
Live — every call hits Shippo's API
Available on
Every plan

Examples

Questions teams actually ask.

The tools it pulls from are shown inline — every answer in Lumen cites the underlying records it read.

Tracking

Latest tracking status for every shipment we sent in the last 7 days that hasn't shown delivery.

pullslistShipmentsgetTracking
Cost

Average label cost by carrier and service over the last 30 days.

pullslistTransactions
Performance

Median transit time from label creation to delivery, broken down by carrier.

pullslistShipmentsgetTracking

Scope

What Lumen sees. What it can change.

Read is on by default. Every write is a separate toggle, capped per user, and logged.

Read

What Lumen reads

Lumen calls the Shippo REST API using the API token you paste at install. Read scope only by default.

  • Carrier accounts

    List of connected carriers, services, and accounts

  • Shipments

    Search by date / status; rates quoted; selected service; from/to addresses

  • Transactions

    Purchased labels with carrier, service, cost, tracking number

  • Tracking

    Latest status, ETA, full event timeline by tracking number

  • Addresses

    Validation result, normalised form, flagged undeliverables

Write · opt-in

What Lumen can write

Lumen does not buy labels or refund transactions by default. These can be admin-enabled per workspace if you want the agent to act.

    Every call is logged with user, operation, shipment or tracking number, and date range. Exportable as CSV.

    Install

    Connect in under a minute.

    No keys, no call, no app marketplace fine print.

    1. Generate a token
      01

      Create a Shippo API token

      In Shippo → API → Tokens, generate a Live token (or Test token if you want a sandbox). Copy the value.

    2. Connect
      02

      Paste the token into Lumen

      In Settings → Integrations → Shippo, paste the token. It's stored encrypted at rest.

    3. Ask
      03

      Try a warm-up question

      Start with "Average label cost by carrier last 30 days" — the agent will pull transactions and break down by carrier.

    Connect Shippo. Audit shipping spend honestly.

    API token. Read-only by default. Label purchase opt-in.