Actions68
- Parcels Actions
- Shipments Actions
- Rates Actions
- Transactions Actions
- Customs Items Actions
- Tracking Status Actions
- Batches Actions
- Orders Actions
- Pickups Actions
- Service Groups Actions
- Customs Declarations Actions
- Refunds Actions
- Manifests Actions
- Carrier Accounts Actions
- Webhooks Actions
- Carrier Parcel Templates Actions
- User Parcel Templates Actions
- Rates At Checkout Actions
- Shippo Accounts Actions
- Addresses Actions
Overview
The "List Addresses" operation of the Shippo node retrieves a paginated list of addresses from the Shippo API. This is useful when you want to fetch multiple saved or processed addresses for shipping, billing, or contact purposes within your workflow. Typical use cases include syncing address data with other systems, validating stored addresses, or displaying address lists for further processing.
Properties
| Name | Meaning |
|---|---|
| Page | The page number of results to retrieve. Useful for navigating through multiple pages of addresses. |
| Results | The number of address records to return per page. Maximum allowed is 100; default is 5. |
| 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 containing an array of address objects retrieved from the Shippo API. Each address object typically includes fields such as name, street address, city, state, postal code, country, and other relevant address details. This structured output can be used downstream in workflows for shipping label creation, address validation, or record keeping.
No binary data output is produced by this operation.
Dependencies
- Requires an active Shippo API key credential configured in n8n.
- Makes HTTP requests to the Shippo API endpoint at
https://api.goshippo.com. - Optionally supports specifying the API version via a custom header.
Troubleshooting
- Invalid API Key or Authentication Errors: Ensure that the Shippo API key credential is correctly set up and has the necessary permissions.
- Pagination Issues: If no results are returned, verify that the
PageandResultsparameters are within valid ranges and that there are addresses available on the requested page. - API Version Header Misuse: Providing an incorrect or unsupported API version string may cause errors. Refer to Shippo's API versioning documentation to use valid versions.
- Rate Limits: Excessive requests may trigger rate limiting by Shippo. Implement appropriate delays or error handling to manage this.