Skip to main content
If you already use the Shippo for Platforms API to support your merchants, you may choose to update your integration to take advantage of the Shippo API. Follow this guide to learn how.

​
Change your Base URL

Previously, Shippo for Platforms used the base URL https://platform-api.goshippo.com. To use the Shippo API, change your base URL to https://api.goshippo.com/.

​
Reference Merchants using a header, not a parameter

Previously, you referenced merchants using a parameter, for example: 
curl https://platform-api.goshippo.com/merchants/{MerchantId}/addresses/
where {MerchantId} is the object ID of your merchant. To use Managed Shippo Accounts in the Shippo API, you reference your Managed Account merchant using a header element. For example: 
curl https://api.goshippo.com/addresses/ -H 'SHIPPO-ACCOUNT-ID: adcfdddf8ec64b84ad22772bce3ea37a'
where SHIPPO-ACCOUNT-ID is the object ID of your Managed Account merchant.

​
Renamed endpoints

The following endpoints have changed. Follow the examples in our reference documentation to update your integration.

​
Example

To list all the address stored in a merchant’s account
Shippo API
curl https://api.goshippo.com/addresses/ \
  -H 'Authorization: ShippoToken <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -H 'SHIPPO-ACCOUNT-ID: <ShippoAccountID>'
Platform API
curl https://platform-api.goshippo.com/merchants/{MerchantId}/addresses/ \
  -H 'Authorization: ShippoToken <API_TOKEN>' \
  -H 'Content-Type: application/json'
NoteYou do not need to migrate any data from your existing Platforms account.