Site Logo

Direct Login

ShipEngine partners have the ability to create and manage ShipEngine accounts on behalf of their customers.

In order for one of their customers to access ShipEngine’s discounted carrier rates, they must complete ShipEngine’s Onboarding Element or onboard within the ShipEngine Carrier Portal.

During either process, the customer will need to accept carrier terms, enter billing information, and then fund a balance to pay for ShipEngine’s carrier services.

Direct Login to the Carrier Portal

The ShipEngine Carrier Portal is a special version of the ShipEngine Dashboard designed to let customers of partners complete a branded onboarding wizard or manage carriers and billing information.

The Direct Login feature allows a partner to generate a URL to the ShipEngine Carrier Portal for a specific customer, without requiring them to enter their username or password.

This guide will go through how to generate a link to the ShipEngine Carrier Portal for your merchants.

Generate a Token

To access the ShipEngine Carrier Portal, you must generate an authorization token. This token has a 10 second lifespan so it should be generated just-in-time each time dashboard access is requested.

On-Behalf-Of should be set with the customer account’s API key you wish to create an access token for.

You can specify a parameter at this endpoint that will return a constructed URL that you can use for redirecting. See the “Configure a URL” section below for details.

POST /v1/tokens/ephemeral&redirect=shipengine-dashboard HTTP/1.1
Content-Type: application/json
"token": "eyJ..",
"redirect_url": ""

Configure a URL

The call to generate a token also generates a URL you can use to redirect your customer to the ShipEngine carrier portal. Use the redirect_to parameter to determine which page your customer will land on by default. You can redirect to the Carriers, Billing, or Onboarding pages. Add the theme_id parameter to this URL before redirecting your customer so they will be directed to a branded experience. Review our Customize Themes with the Partner API page for more details about creating a branded onboarding experience.

Query parameters should be appended to the end of the URL string.

Query ParameterTypeDescription
theme_idstringThe theme ID value, returned in the create theme response.
redirect_tostringAvailable values are carriers, billing, and onboarding.
If onboarding is not complete, the customer will always be redirected to the Onboarding screen. Otherwise, if this parameter is not specified, the customer be redirected to the Carriers screen.
If using onboarding as the value but onboarding is complete, the customer will be redirected to the Carriers page.



Default Experience

Below please find a series of screenshots for the default flow for onboarding.


The following items can be customized in the onboarding experience for your customers using the Theme endpoint:

  • Custom logo image
  • Custom start title and message
  • Custom complete title and messge

We may offer partners additional customization of the ShipEngine Carrier Portal for an additional fee as part of their contractual agreement. Below are some of the bespoke options available:

  • Users subscribe to a ShipEngine billing plan
  • Show additional discounted carriers
  • User can access label branding
  • User can access branded tracking page setup
  • Whitelist/Blacklist Carriers
  • Customer Chat Support