The Sender Addresses section in the EasyPost dashboard stores and manages shipping addresses. Multiple addresses can be added for shipping from different locations or for return addresses.
EasyPost categorizes addresses into two types: the Sender Address and the Return Address. Carriers require both addresses to create a shipping label.
Sender Address
- Represents the location from which the package is being shipped.
- Used to calculate the rate for the shipping label.
Return Address
- Designated as the location where the package will be sent if the carrier cannot complete the delivery.
- Appears on the printed label.
This article provides a guide on managing Sender and Return Addresses using the EasyPost dashboard.
Add a New Address
- Log in to the EasyPost dashboard.
- Navigate to Shipping Settings > Sender Addresses.
- Select the Add an Address button and click Add New Address.
- Fill out each field in the form:
- Address Nickname: Required for internal reference.
- Set address as default?: Optional setting for the primary sender or return-to location.
- Contact Details: Required field; enter the Company Name if a personal name is not desired.
- Phone Number: Optional but highly recommended, especially for international shipments.
- Preview the address at the bottom of the form before clicking Save Address. This is how the address will appear on the shipping label.
Editing an Existing Address
- Locate the address in the saved addresses list.
- Click on the stacked dots on the far right of the row and select Manage Address.
- Make edits, preview, then click Update Address.
Note: These edits will create a new Address ID. If using the API, review the Addresses section of the API Docs.
Set a Default Address
- Locate the address in the saved addresses list.
- Click on the stacked dots on the far right of the row and select Manage Address.
- Set address as default? Select Sender, Return To, or both.
Note: Setting a new default address will override any previous settings.
Default Addresses will be pre-selected as the Sender or Returns address when creating shipping labels using the EasyPost Dashboard.
Delete an Address
- Locate the address in the saved addresses list.
- Click on the stacked dots on the far right of the row and select Delete Address
- Confirm with Yes, Delete.
Note: If the address ID is saved, the same address can be imported again using the Import Address feature.
Information for API users
Addresses in the EasyPost dashboard are stored as EasyPost Address Objects with a unique identifier starting with "adr_." These identifiers are useful for API requests to get rates or create shipments.
Reminder: EasyPost address objects are immutable, so edits to the address (street name, city, etc.) will create a new Address ID. To see the changes, update API Requests to the new Address ID.
For API reference, review the Addresses section of the API Docs.
View the Address ID
There are two ways to view the Address ID within the EasyPost dashboard:
- Expand the address row or manage the address to view and copy the Address ID.
- Select the three stacked dots on the far right of the row and click Manage Address. Use the copy icon to copy the Address ID.
Import an Address by Address ID
If a previously created address should be added back to the EasyPost dashboard, import it using the Address ID.
Note: Only addresses that are associated with the EasyPost account can be imported.
- Select the Add an Address button and click Import Existing Address.
- Enter the Address ID.
- Add a new Address Nickname.
- Set as default by selecting Sender, Return To, or both.
- Click Import Address.