Shippo - Validate Address

Description

This module validates and normalizes a shipping address using the Shippo validation service. It receives the individual address fields (name, company, street, city, state, zip code, country, phone, email) and a validation flag. It makes a POST request to the /addresses/ endpoint and returns the created address with its ID, validation results (valid or not), and validation messages with details.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Shippo credential (provider: shippo)
name	text	Yes	Recipient name
company	text	No	Company name
street1	text	Yes	Main street and number
street2	text	No	Address line 2
city	text	Yes	City
state	text	Yes	ISO state code (e.g.: CA, NY)
zip	text	Yes	Zip code
country	text	Yes	ISO 3166-1 alpha-2 code (default: US)
phone	text	No	Phone number
email	text	No	Email address
validate	boolean	No	Enable address validation (default: true)

Credentials

A shippo type credential is required with the following fields:

api_token: Shippo API Token

Output

{
  "success": true,
  "address": {
    "object_id": "addr_abc123",
    "name": "John Smith",
    "street1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US"
  },
  "address_id": "addr_abc123",
  "is_valid": true,
  "validation_messages": [],
  "message": "Direccion validada exitosamente"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_shippo",
  "name": "Juan Garcia",
  "street1": "123 Main Street",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94105",
  "country": "US",
  "validate": true
}

API Used

Endpoint: POST /addresses/
Base: Shippo API (via helper _shippoHelper)
Documentation: https://goshippo.com/docs/

Notes

Validation is enabled by default (validate: true)
If validation fails, the address is still created but is_valid will be false
Validation messages provide details about the issues found
The returned address_id can be used as a reference in other Shippo nodes
Optional fields (company, street2, phone, email) are only included if they have a value