Need to bulk create shipping labels quickly? Use EasyPost's CSV integration to quickly bulk create shipping labels at once. Upload a CSV with your shipment information and receive a file with all the shipping labels you need.
Quicklinks: CSV Template (Domestic) or CSV Template (International)
Table of Contents:
Appendix: List of all supported headers
If you still need additional help after using this article, please contact our support team and provide your CSV, your error message, and any screenshots if possible.
Getting Started
On the “Shipments” tab of the EasyPost dashboard, click the “CREATE LABELS VIA CSV” button right at the top.
You can also fill out the simple form to create shipping labels one at a time (click here for help article), or use the CSV upload feature to create multiple labels at once. Make sure your account is funded (see Billing Guides) before creating your shipping labels.
You can also change “manually” at the top to “with CSV upload” to enter this flow.
Step 1: Fill out your CSV template
Download our CSV template (use this one for international) and fill it out with your shipment information. Some examples are provided in the template; please delete the example rows before you save your CSV. We support creating up to 500 different shipments in a CSV at once. If you have more than 500 shipments, repeat this process again with additional CSVs.
Save your completed file as a CSV.
Valid CSV headers:
to_address.name to_address.company to_address.phone to_address.email to_address.street1 to_address.street2 to_address.city to_address.state to_address.zip to_address.country |
from_address.name from_address.company from_address.phone from_address.email from_address.street1 from_address.street2 from_address.city from_address.state from_address.zip from_address.country |
parcel.height_in
|
carrier
|
* Leave parcel.predefined_package blank if you are not using a Predefined Package. Valid Predefined Packages can be found at https://www.easypost.com/docs/api#predefined-packages
You must specify a “carrier” and “service” for each shipment. You will only be able to use carriers you have added to your EasyPost account. Remember, all EasyPost accounts come with a USPS carrier account by default. For USPS, valid service levels are:
- First
- Priority
- Express
- ParcelSelect
- LibraryMail
- MediaMail
- FirstClassMailInternational
- FirstClassPackageInternationalService
- PriorityMailInternational
- ExpressMailInternational
For additional carriers and service levels, use the interactive list on https://www.easypost.com/docs/api#service-levels.
Shipping internationally
Shipping internationally? Your CSV will need additional customs information. Make sure you are using our INTERNATIONAL CSV TEMPLATE. As of December 2020, EasyPost's CSV integration only supports 1 customs item per international shipment.
To ship internationally, your CSV needs these additional headers - which are included the international CSV template:
field | description | example |
customs.customs_certify | Electronically certify the information provided | TRUE |
customs.customs_signer | Person certifying the information | Sally Smith |
customs.contents_type | "documents", "gift", "merchandise", "returned_goods", "sample", or "other" | merchandise |
customs.restriction_type | "none", "other", "quarantine", or "sanitary_phytosanitary_inspection" | none |
customs.eel_pfc | value less than $2500: "NOEEI 30.37(a)"; value greater than $2500: see Customs Guide | NOEEI 30.37(a) |
customs_item.description | Description of item being shipped | Men's T-Shirt |
customs_item.quantity | Description of item being shipped | 1 |
customs_item.weight_oz | Total weight (unit weight * quantity) in ounces | 32 |
customs_item.value | Total value (unit value * quantity) | 19.99 |
customs_item.code | SKU/UPC or other product identifier | mens-blue-shirt |
customs_item.hs_tariff_number | Harmonized Tariff Schedule, e.g. "6109.10.0012" for Men's T-shirts | 6109.10.0012 |
customs_item.origin_country | Required, 2 char country code | US |
Printing a message on the label
You can optionally print custom messages on labels. The locations of these fields show up on different spots on the carrier's labels.
To add a message to be printed on your shipping label, add a column titled "options.print_custom_1" to your CSV, and enter our message.
Additional shipping options
If you are looking for additional shipping options, view our complete list of supported headers.
Step 2: Upload your CSV
Make sure your account is funded (see Billing Guides) before creating your shipping labels. On the “Shipments” tab of the EasyPost dashboard, click the “CREATE LABELS VIA CSV” button right at the top.
You can nickname your upload so you can search and refer to it from your EasyPost dashboard later. Attach your CSV and click "BUY LABELS" - this will start buying the labels; please be patient!
Step 3: Download and print your shipping labels
Yay! You have just created shipping labels! The confirmation screen will show you how many total labels you purchased and the total label costs for each carrier. (You can always use your Shipments dashboard & CSV report to view information on individual shipments.)
Next, you'll want to download all those shipping labels you made into one file so you can send it to your printer easily. Choose your file format (PDF/ZPL/EPL2) and click "LABEL" to get your final document!
Error Handling
It's possible that your batch may have some shipments with errors. No fear, you can still get the labels that you purchased, but first you have to remove the errors from the batch. When you remove the errors, you will receive a CSV of the error shipments and the corresponding error messages.
Click the "DOWNLOAD & REMOVE ERRORS" button to remove your errors from the batch.
After you download your successful labels, you'll need to re-upload a new CSV to get the shipping labels for those failed shipments. Use the error messages to guide you to fix your CSV. After you think you've fixed all the errors, repeat this process with a CSV of just those failed shipments.
----------------------------------------------------------------------------------------------------
Appendix
Full list of supported headers
If you are looking for any additional shipping options, this is a full list including advanced options that we support through the CSV upload tool. For additional help, visit our API documentation or contact support.
Supported CSV headers:
reference | |||
is_return | |||
from_address.name | to_address.name | return_address.name | buyer_address.name |
from_address.company | to_address.company | return_address.company | buyer_address.company |
from_address.phone | to_address.phone | return_address.phone | buyer_address.phone |
from_address.email | to_address.email | return_address.email | buyer_address.email |
from_address.street1 | to_address.street1 | return_address.street1 | buyer_address.street1 |
from_address.street2 | to_address.street2 | return_address.street2 | buyer_address.street2 |
from_address.city | to_address.city | return_address.city | buyer_address.city |
from_address.state | to_address.state | return_address.state | buyer_address.state |
from_address.zip | to_address.zip | return_address.zip | buyer_address.zip |
from_address.country | to_address.country | return_address.country | buyer_address.country |
from_address.residential | to_address.residential | return_address.residential | buyer_address.residential |
from_address.carrier_facility | to_address.carrier_facility | return_address.carrier_facility |
buyer_address.carrier_facility
|
from_address.federal_tax_id | to_address.federal_tax_id | return_address.federal_tax_id |
buyer_address.federal_tax_id
|
from_address.state_tax_id | to_address.state_tax_id | return_address.state_tax_id |
buyer_address.state_tax_id
|
from_address.verify | to_address.verify | return_address.verify | buyer_address.verify |
from_address.verify_strict | to_address.verify_strict | return_address.verify_strict | buyer_address.verify_strict |
parcel.length_in | |||
parcel.width_in | |||
parcel.height_in | |||
parcel.weight_oz | |||
parcel.predefined_package | |||
carrier | |||
service | |||
options.additional_handling | |||
options.address_validation_level
|
|||
options.alcohol | |||
options.by_drone | |||
options.carbon_neutral | |||
options.cod_amount | |||
options.cod_method | |||
options.currency | |||
options.delivery_confirmation
|
|||
options.dropoff_type | |||
options.dry_ice | |||
options.dry_ice_medical | |||
options.dry_ice_weight | |||
options.endorsement | |||
options.freight_charge | |||
options.handling_instructions | |||
options.hazmat | |||
options.hold_for_pickup | |||
options.incoterm | |||
options.invoice_number | |||
options.label_date | |||
options.label_format | |||
options.machinable | |||
options.bill_third_party_account | |||
options.bill_third_party_country | |||
options.bill_third_party_postal_code | |||
options.print_custom_1 | |||
options.print_custom_2 | |||
options.print_custom_3 | |||
options.print_custom_1_barcode
|
|||
options.print_custom_2_barcode
|
|||
options.print_custom_3_barcode
|
|||
options.print_custom_1_code
|
|||
options.print_custom_2_code
|
|||
options.print_custom_3_code
|
|||
options.saturday_delivery | |||
options.special_rates_eligibility
|
|||
options.smartpost_hub | |||
options.smartpost_manifest | |||
options.billing_ref | |||
options.certified_mail | |||
options.registered_mail | |||
options.registered_mail_amount
|
|||
options.return_receipt | |||
customs.customs_certify | |||
customs.customs_signer | |||
customs.contents_type | |||
customs.restriction_type | |||
customs.eel_pfc | |||
customs_item.description | |||
customs_item.quantity | |||
customs_item.weight_oz | |||
customs_item.value | |||
customs_item.code | |||
customs_item.hs_tariff_number
|
|||
customs_item.origin_country |
Comments
0 comments
Article is closed for comments.