create_shipment
Create a shipment to get available shipping rates from all connected carriers. Provide sender/recipient addresses and parcel details. Rates are automatically generated and can be used to purchase labels. Supports inline address/parcel objects or existing object IDs.
get_rates
Retrieve available shipping rates for an existing shipment. Use this to compare carrier options, prices, and estimated delivery times. Returns one provider page; ordering is not guaranteed.
purchase_batch
Purchase all labels in an existing batch. The batch must be in VALID status. After purchasing, labels and tracking numbers will be generated for all shipments in the batch.
track_shipment
Get the current tracking status and full tracking history for a shipment. Provide a carrier token and tracking number. Works for any shipment, including those created outside of Shippo.
schedule_pickup
Schedule a carrier pickup for eligible shipments. Currently supported for USPS and DHL Express. Specify the pickup location, time window, and the transactions (labels) to be picked up.
create_refund
Request a refund for an unused shipping label. You must explicitly request refunds — unused labels are not automatically refunded. Provide the transaction (label) ID to refund.
list_parcel_templates
List all user-created parcel templates and optionally carrier-provided parcel templates. Carrier templates include predefined dimensions (e.g. USPS Flat Rate boxes).
create_parcel_template
Create a reusable parcel template with preset dimensions and weight. Useful for standardized packaging. You can base it on a carrier parcel template or define fully custom dimensions.
create_order
Load an order into Shippo for shipping management. Orders represent customer purchase requests and can be used to generate shipping rates and labels through the Shippo dashboard or API.
list_addresses
Retrieve a paginated list of all stored addresses. Use this to browse saved addresses for reuse in shipments.
create_customs_declaration
Create a customs declaration for international shipments. Include customs items describing the contents, their values, and countries of origin. Requirements depend on the carrier, destination and contents.
create_manifest
Create a manifest (SCAN form) to close out shipping labels for a given day. A manifest is a single-page document with a barcode that carriers can scan to accept all packages at once. Some carriers require daily manifests.
validate_address
Validate an existing address to check for accuracy and prevent failed deliveries. Returns validation results with any suggested corrections.
purchase_label
Purchase a shipping label. You can either select a rate from an existing shipment, or create a label in a single call by providing full shipment details along with carrier and service level. Provides a downloadable label when successful and the tracking number. A purchase can charge the connected account; queued status does not mean a label is ready.
create_address
Create and optionally validate a shipping address. Addresses are used as sender or recipient in shipments. When validation is enabled, Shippo checks the address for accuracy and provides suggestions.
list_transactions
Retrieve a paginated list of transactions (label purchases). Filter by rate or tracking status. Use this to browse purchased labels and their statuses.
create_batch
Create a batch by copying the details of existing shipments into new batch shipments. Provide a default carrier account and service level, along with the batch shipments. After creation, purchase the batch to generate all labels.
list_carrier_accounts
Retrieve all connected carrier accounts. Use this to see which carriers are available for rate shopping and label creation. Filter by carrier name to find specific accounts.
get_shipment
Retrieve details of a specific shipment by ID, including its addresses, parcels, and status. Also useful for checking if rates are ready for async shipments.
list_orders
Retrieve a paginated list of all orders in your Shippo account. Use this to browse orders for shipping management.
get_transaction
Retrieve details of a specific transaction (label purchase) by ID. Returns label URL, tracking number, and current status. Useful for checking async label generation or retrieving label URLs.
register_tracking
Register a tracking number for webhook-based updates. Once registered, Shippo will send tracking status changes to your configured webhook endpoint. You must have a tracking webhook configured before calling this.
get_current_context
Verify read-only access and report authentication mode and known API-token test state. This connection does not expose a verified user or account identity.
download_document
Download an existing transaction label or commercial invoice, manifest document, or merged batch label file. This tool does not buy a label or create a manifest.
get_shipping_resource
Retrieve an existing order, refund, manifest or batch by exact ID. Inspect asynchronous status and batch validation/purchase results before taking another action.