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 list refunds associated with shipments. It is useful for users who want to retrieve and manage refund data from their Shippo account, such as tracking refund statuses or auditing refund transactions. Practical examples include generating reports of all refunds issued within a certain period or integrating refund information into customer service workflows.

Properties

Name	Meaning
SHIPPO API VERSION	Optional string to specify a non-default version of the Shippo API to use for the request. See Shippo's API versioning guide for details.

Output

The node outputs JSON data representing a list of refunds retrieved from the Shippo API. Each item in the output typically contains details about an individual refund, such as refund ID, status, amount, currency, and related shipment information. The output does not include binary data.

Dependencies

Requires an active Shippo API key credential configured in n8n.
Connects to the Shippo API endpoint at https://api.goshippo.com.
Optionally supports specifying the API version via a header if the user wants to target a specific Shippo API version.

Troubleshooting

Common issues:
- Invalid or missing API key will cause authentication errors.
- Using an unsupported or incorrect API version string may result in API errors or unexpected responses.
- Network connectivity problems can prevent successful API calls.
Error messages and resolutions:
- 401 Unauthorized: Check that the API key credential is correctly set up and has proper permissions.
- 400 Bad Request: Verify that the API version string (if provided) is valid according to Shippo's documentation.
- Timeout or network errors: Ensure stable internet connection and that the Shippo API endpoint is reachable.