ShipHero - Enable API Access

Neil G · Updated November 10, 2026 20:53

This article is for whoever connects a ShipHero fulfillment destination inside DropStream — a fulfillment provider (3PL) or a merchant who manages their own DropStream account. ShipHero is an order destination: DropStream sends orders to it for fulfillment. You’ll add it through DropStream’s Add Connection wizard.

If you haven’t gathered your credentials yet, do that first — ShipHero - Gather API Credentials.

What you’ll need

A DropStream account you can sign in to.
Your ShipHero Access Token and Refresh Token — see ShipHero - Gather API Credentials.

How DropStream connects to ShipHero

A destination is added through the same Add Connection wizard, at the Warehouse Setup step. For the full walkthrough, see Add a Connection. This article covers only the ShipHero-specific details you enter there. (You can also edit these values later from the warehouse under Connections.)

Enter your ShipHero details

In the Add Connection wizard, work through to the Warehouse Setup step. Choose Create new warehouse and give it a Warehouse Name. Your account is already configured for ShipHero, so ShipHero is pre-selected as the Platform — you don’t need to choose it. The ShipHero fields appear below.

Enter your credentials:

Field	What it is	Example
Access Token	The ShipHero API token that authorizes DropStream to send orders to your account	`eyJhbGciOiJSUzI1NiIs…`
Refresh Token	A long-lived token DropStream uses to renew the access token automatically, so the connection doesn’t expire	`def5020087a1b2c3…`

For where to find these, see ShipHero - Gather API Credentials.

The Customer Account ID fills in automatically once a valid Access Token is entered — you don’t type it. If it stays blank, the Access Token is missing or invalid; re-enter it.
Finish the wizard to save the connection.

Notes

Treat the Access Token and Refresh Token like passwords — anyone with them can submit orders to your ShipHero account.
The Customer Account ID is derived from the Access Token. A blank value is the usual sign of an expired or mistyped token.
To update these credentials later, open the warehouse under Connections and edit its Warehouse settings.
If DropStream reports an error such as “User does not have permissions to access …”, the token works but its ShipHero user is missing a permission. Update that user’s role in ShipHero, or generate tokens for a user that has the access, then enter the new tokens here. See ShipHero - Gather API Credentials.