Create a send-from address
Creates a new send-from address (warehouse, fulfillment center).
Used as `from_address` when purchasing labels.
Parameters
Request Body
address_code
string
Required
Unique identifier code for this warehouse/location.
Used for quick reference in batch operations.
name
string
Location name (e.g., warehouse name)
company
string
Company name shown on shipping labels
contact_person
string
Contact person at this location
street1
string
Required
Primary street address
street2
string
Secondary address (suite, unit, dock number)
city
string
Required
state
string
Required
2-letter state code
zip
string
Required
ZIP code
country
string
ISO 2-letter country code
phone
string
Contact phone (required for some carriers)
email
string
Contact email for notifications
timezone
string (America/New_York | America/Chicago | America/Denver | America/Los_Angeles | America/Phoenix | America/Anchorage | Pacific/Honolulu)
IANA timezone for this location.
Used for business hours and pickup scheduling.
business_hours
object
Weekly business hours for pickup scheduling.
Carriers will schedule pickups within these hours.
is_default
boolean
Set as the default origin address.
Only one address can be default at a time.
is_active
boolean
Enable or disable this address
is_pickup
boolean
Allow carrier pickups at this location.
Required for scheduling pickups via `POST /v1/pickups`.
is_return
boolean
Use as return address on shipping labels.
When enabled, this address will be used for:
- Return labels (RMA)
- Undeliverable package returns
residential
boolean
Is this a residential address? (rare for warehouses)
Returns
201
Address created successfully
400
Invalid address data
401
Authentication required
Related
Addresses
POST/api/v1/addresses