Shippo icon

Shippo

Interact with Shippo API

Actions68

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 Page and Results parameters 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.

Links and References

Discussion