Shipping to P.O. Boxes: Is it a No? Or Is it a Go?

Shippo Snippets: Shipping to a P.O. box presents a range of benefits and drawbacks for merchants and consumers alike P.O. boxes can often be managed online USPS’s MTC SA service can provide P.O. box users with an actual street address From convenience to cost, carrier specifications, security, pri...

How to Send a Prepaid Return Shipping Label via USPS

According to a UPS report, 34 percent of customers want to see a prepaid return shipping label in the box.  Putting the shipping label in the box makes it much easier for customers to return the item, since they don’t have to figure out how to create a shipping label in order to mail back…

Brand Matters: How You Can Stand Out and Beat the Competition

So you have an e-commerce business. You’re passionate about your product, excited to get it to your customers and grow your business. But, like so many merchants in 2020, you’re wary of intense competition. Almost anything a consumer could possibly want is available at the tap of a finge...

Using Packaging to Boost Your Brand and Gain a Competitive Advantage

Shippo Snippets: Keeping your brand packaging design consistent with your marketing efforts will help your customers become familiar with your product so they can easily identify it in the future Ultimately, your customer should be able to “read” your shipping packaging at just a mere glance The...
Dev Corner | October 27, 2016

Introducing API Versioning and Test Mode

shippo version 2016-10-25

We are excited to introduce the next version of Shippo API.

After printing millions of labels and having thousands of developers integrating our API, we’ve  taken all the feedback and decided to improve the API by rolling out versioning.

We will continue to improve and release new features for all versions of our API as we have done in the past. However, we’ve been restricted with old functionalities, being careful that we don’t break any existing integrations.

Now, with API versioning, we can systematically release updates that may be backwards-incompatible and let developers choose if they’d like to upgrade. We hope this improves the developer experience for all of our customers.

Current Shippo users can continuing using Shippo as is, and test their code under a different API version before upgrading.

Simply set Shippo-API-Version in the header with the version you are testing.

  curl https://api.goshippo.com/shipments/        -H "Authorization: ShippoToken <PRIVATE_TOKEN>"       -H "Shippo-API-Version: YYYY-MM-DD"       -d '{ ... }'  # now this API request uses the API version "YYYY-MM-DD"

Learn more about API versioning and check out our changelog for details about the latest versions.

Test Mode for Version 2016-10-25

With this new version, we’ve introduced Test Tokens for the Shippo API. You’ll be able to set your account to full test mode, and use the API without being worried about being charged.

Test Tokens are simple to use. Just insert it in place of your Live Token, and off you go. From creating Shipments all the way to generating test labels, you’ll be able to try out the Shippo API end-to-end.

Review Test Mode documentation to learn more.


Shippo is a multi-carrier API and web app that helps retailers, marketplaces and platforms connect to a global network of carriers. Businesses use Shippo to get real-time rates, print labels, automate international paperwork, track packages and facilitate returns. Shippo provides the tools to help businesses succeed through shipping.

Shippo Engineering

Get Started Today for Free

Everything you need for professional-grade shipping + deep discounts from top carriers.
Sign Up Free