
Shippo
Read and write Shippo addresses, parcels, shipments, rates, labels, tracking, orders, customs declarations, manifests and carrier accounts.
Rate-shop and buy labels across carriers from order flows, register tracking and feed shipping status back to commerce and service tools.
Source actions
23
Destination actions
8
Data types
14
Validation status
Implemented · fixture tested.
Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.
What you can map
address validations
- Validate addressSource
Validate a saved address and return the validation results.
address_validations.get
addresses
- Create addressDestinationNot retried automaticallyApproval before production
Create an address, optionally validating it.
addresses.create - Get addressSource
One address by object ID.
addresses.get - List addressesSource
Saved addresses with validation results.
addresses.list
batches
- Get batchSource
One label batch with status and label URLs.
batches.get
carrier accounts
- Get carrier accountSource
One carrier account by object ID.
carrier_accounts.get - List carrier accountsSource
Carrier accounts available for rating and labels, with service levels.
carrier_accounts.list
customs declarations
- Create customs declarationDestinationNot retried automaticallyApproval before production
Create a customs declaration from customs items.
customs_declarations.create - Get customs declarationSource
One customs declaration by object ID.
customs_declarations.get - List customs declarationsSource
Customs declarations for international shipments.
customs_declarations.list
customs items
- Create customs itemDestinationNot retried automaticallyApproval before production
Create a customs line item for a declaration.
customs_items.create - Get customs itemSource
One customs item by object ID.
customs_items.get - List customs itemsSource
Customs line items.
customs_items.list
manifests
- Get manifestSource
One manifest by object ID.
manifests.get - List manifestsSource
Carrier manifests (scan forms) with documents.
manifests.list
orders
- Create orderDestinationNot retried automaticallyApproval before production
Create an order for fulfilment in Shippo.
orders.create - Get orderSource
One order with line items and label transactions.
orders.get - List ordersSourceIncremental
Orders imported from stores or created by API.
orders.list
parcels
- Create parcelDestinationNot retried automaticallyApproval before production
Create a parcel from dimensions and weight, or from a carrier template.
parcels.create - Get parcelSource
One parcel by object ID.
parcels.get - List parcelsSource
Saved parcels with dimensions and weight.
parcels.list
rates
- Get rateSource
One rate by object ID.
rates.get
shipment rates
- List shipment ratesSource
Rates for a shipment, optionally converted to a currency.
shipment_rates.list
shipments
- Create shipmentDestinationNot retried automaticallyApproval before production
Create a shipment and return carrier rates. No postage is charged until a transaction is created.
shipments.create - Get shipmentSource
One shipment with its rates.
shipments.get - List shipmentsSourceIncremental
Shipments with addresses, parcels and returned rates.
shipments.list
tracking
- Register tracking webhookDestinationProvider duplicate protectionApproval before production
Register a tracking number so Shippo sends track_updated webhooks.
tracking.create - Get tracking statusSource
Tracking status and history for a carrier and tracking number.
tracking.get
transactions
- Purchase labelDestinationNot retried automaticallyApproval before production
Purchase a label for a rate (synchronously). Charges postage on live tokens.
transactions.create - Get labelSource
One transaction (label) by object ID.
transactions.get - List labelsSourceIncremental
Purchased labels (transactions) with tracking and label URLs.
transactions.list
Authentication
Shippo API token (live or test)
Plans and access
All Shippo plans with an API token; label purchases are charged per label. Live tokens buy real postage; test tokens (shippo_test_) return test labels without charges.
Test environment
Use a shippo_test_ token for test mode; labels and tracking use the Shippo test carrier.
Rate limits
Per minute, live/test: most POST 500/50, single GET 4,000/400, list GET 50/10; tracking POST 750/50 and GET 500/50; HTTP 429 when exceeded.
Pagination
page and results (max 100) with next/previous URLs; Nexra follows next.
Provider events
Webhooks for transaction_created, transaction_updated, track_updated and batch events. Nexra event triggers are not yet available; flows run on demand or on a schedule.
Before you build a flow
- transactions.create purchases a label (billable) and has no idempotency key; Nexra never retries it.
- Refunds, batch purchase, pickups and carrier-account registration are not implemented.
- Shippo has no batch list endpoint; batches are read by ID.
- Shipments, parcels and addresses are immutable once created; there are no update operations.
Developer reference
- Create the Shippo credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Shippo, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/shippo and the Connections API.