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:

1. Fill out your CSV using the provided template
   1. Shipping internationally
   2. Printing a message on the label
2. Upload your CSV
3. Download your labels
4. Error handling

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:

* 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:

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: