Skip to content
Last updated

Migrating from Platform API to Shippo API

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

curl https://api.goshippo.com/addresses/ \
  -H 'Authorization: ShippoToken <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -H 'SHIPPO-ACCOUNT-ID: <ShippoAccountID>'
curl https://platform-api.goshippo.com/merchants/{MerchantId}/addresses/ \
  -H 'Authorization: ShippoToken <API_TOKEN>' \
  -H 'Content-Type: application/json'
Note

You do not need to migrate any data from your existing Platforms account.