This article covers everything you need to connect your Passport account to ShipHero and configure your settings.
Before You Begin
You will need an active Passport account at passportshipping.com and your API Access Token. See Getting the Passport API Access Token below if you haven't generated one yet.
New to Passport? See Overview: Passport International Shipping in ShipHero first.
Table of Contents
- Getting the Passport API Access Token
- How to Connect Passport to ShipHero
- Available Passport Settings After Connecting
- Important Reminders
Getting the Passport API Access Token
To authenticate the connection between ShipHero and Passport's API, you must provide an API Access Token. This is a secure credential (maximum 255 characters) unique to your Passport account.
- Active Account: Ensure you have an active account at passportshipping.com.
- Generate Token: Log in to your Passport dashboard to locate your API credentials. If you do not see an option to generate a token, contact your Passport Account Manager.
- Complete Connection: Once you have the token, paste it into the API Access Token field in the ShipHero Connect Carrier window to finish the setup.
Important
Access tokens are sensitive information. Store them securely and do not share them outside of your authorized integration users.
How to Connect Passport to ShipHero
Follow these steps to connect Passport to ShipHero:
- Go to the Shipping > Carriers page.
- Click the Connect Carrier button and select Passport from the list of available carriers.
- Enter the required information into the following fields.
- Click Connect.
Required Passport Connection Fields
| Field | Description |
|---|---|
| Warehouse | Select the warehouse that will fulfill these orders. |
| Profile | Choose the specific Warehouse Profile to associate with this carrier. |
| API Access Token | Enter your unique credential obtained from Passport. |
Available Passport Settings After Connecting
After connecting your Passport account to ShipHero the following settings are available:
| Setting | Description |
|---|---|
| Cut-Off Time | Labels generated after this time will print with the creation date of the following day. |
| Disable Quoting | Prevents this account from being quoted in rate shopping tools or when using cheapest shipping methods. |
Important Reminders when Connecting a Carrier Account
- Using Custom Profiles: Custom profiles allow you to connect the same carrier account multiple times with unique settings, such as specific Incoterms or 3rd Party Billing. For these settings to apply, the order must be assigned to that specific profile. If the assigned profile lacks a connected carrier, ShipHero will automatically use the carrier account connected the warehouse’s default profile for the selected shipping method. This ensures your specialized billing and shipping terms are applied correctly to every label. Visit the following article for more information on How to Use Warehouse Profiles.
- Multi-Warehouse Accounts: To generate labels from multiple warehouses, you must connect your carrier account to each individual location in ShipHero to avoid shipping errors or billing discrepancies. Please consult your carrier to determine if a single account number supports multiple origins or if unique accounts are required for each site. This is especially critical for international locations, as carrier operations vary by country.
- Note for 3PLs: When connecting a new carrier account to ShipHero, double check your 3PL Clients' Settings to ensure you are connecting the carrier account to the correct ShipHero account; if Use Customer's Shipping Accounts is enabled the carrier account must be connected at the child account level, if Use Customer's Shipping Account is not enabled, the carrier account needs to be enabled at the 3PL level. More information about Managing 3PL Client Settings can be found here.