Shippo

Interact with Shippo API

Actions68

Parcels Actions
- Create Parcel
- Get Parcel
- List Parcels
Shipments Actions
- List Shipments
- Create Shipment
- Get Shipment
Rates Actions
- Get Rate
- List Shipment Rates
- List Shipment Rates By Currency Code
Transactions Actions
- List Transactions
- Create Transaction
- Get Transaction
Customs Items Actions
- List Customs Items
- Create Customs Item
- Get Customs Item
Tracking Status Actions
- Create Track
- Get Track
Batches Actions
- Create Batch
- Get Batch
- Add Shipments To Batch
- Purchase Batch
- Remove Shipments From Batch
Orders Actions
- List Orders
- Create Order
- Get Order
Pickups Actions
- Create Pickup
Service Groups Actions
- List Service Groups
- Create Service Group
- Update Service Group
- Delete Service Group
Customs Declarations Actions
- List Customs Declarations
- Create Customs Declaration
- Get Customs Declaration
Refunds Actions
- Create Refund
- List Refunds
- Get Refund
Manifests Actions
- List Manifests
- Create Manifest
- Get Manifest
Carrier Accounts Actions
- List Carrier Accounts
- Create Carrier Account
- Get Carrier Account
- Update Carrier Account
- Initiate Oauth 2 Signin
- Register Carrier Account
- Get Carrier Registration Status
Webhooks Actions
- Get Webhook
- Update Webhook
- Delete Webhook
Carrier Parcel Templates Actions
- List Carrier Parcel Templates
- Get Carrier Parcel Template
User Parcel Templates Actions
- List User Parcel Templates
- Create User Parcel Template
- Delete User Parcel Template
- Get User Parcel Template
- Update User Parcel Template
Rates At Checkout Actions
- Create Live Rate
- Get Default Parcel Template
- Update Default Parcel Template
- Delete Default Parcel Template
Shippo Accounts Actions
- List Shippo Accounts
- Create Shippo Account
- Get Shippo Account
- Update Shippo Account
Addresses Actions
- List Addresses
- Create Address
- Get Address
- Validate Address

Overview

This node interacts with the Shippo API to retrieve the registration status of a carrier account. Specifically, it allows users to query the current registration state for a selected shipping carrier such as UPS, USPS, or Canada Post. This is useful in scenarios where you need to verify if your account with a particular carrier is active and properly registered before initiating shipments or other carrier-specific operations.

Practical examples include:

Checking if your UPS account is registered and ready to use before creating shipment labels.
Validating USPS account status programmatically as part of an automated shipping workflow.
Monitoring carrier account statuses across multiple carriers to ensure smooth logistics operations.

Properties

Name	Meaning
Carrier	Select the specific carrier to check the registration status for. Options: Ups, Usps, Canada Post
SHIPPO API VERSION	Optional header to specify a non-default version of the Shippo API to use for this request

Output

The node outputs JSON data representing the registration status of the specified carrier account. The structure typically includes details about whether the carrier account is registered, any relevant status messages, and possibly metadata related to the carrier account.

If the node supports binary data output (not indicated here), it would generally relate to documents or files returned by the API, but this node focuses on JSON responses about carrier registration status.

Dependencies

Requires an API key credential for authenticating with the Shippo API.
The node sends requests to https://api.goshippo.com.
Optionally supports specifying the Shippo API version via a custom header.
No additional external dependencies beyond the Shippo API and n8n's HTTP request capabilities.

Troubleshooting

Common issues:
- Invalid or missing API key will cause authentication errors.
- Selecting a carrier not supported or misspelling the carrier name may result in errors or empty responses.
- Using an unsupported or incorrect API version string could lead to unexpected API errors.
Error messages:
- Authentication failures: Check that the API key credential is correctly configured and has necessary permissions.
- "Carrier not found" or similar: Verify the carrier property value matches one of the allowed options exactly.
- API version errors: Ensure the SHIPPO API VERSION property is either left blank or set to a valid version string per Shippo’s documentation.