Part 1 — Get Your XPO API Credentials
You will need the following from XPO before configuring anything in Shipwell:
XPO User ID and Password — your XPO customer portal login
XPO Customer Number — found on a previous BOL or invoice
Basic Auth Key — a base64-encoded value of your Consumer Key and Consumer Secret, provided by XPO
Already have all of these? Skip to Part 2.
Step 1 — Create an XPO Account (if you don't have one)
Set up a business account with XPO by calling 1-800-755-2728, or register online at ltl.xpo.com.
Step 2 — Request API Credentials
If you have an XPO account but do not yet have API credentials, contact your XPO account representative to request them. They may ask the following questions — here are the answers to provide:
What REST API integrations will you be using? Rating API
What type of API consumer are you? TMS Customer
What TMS or service provider are you connecting through? Shipwell
Your rep will provide a Consumer Key and Consumer Secret. The Basic Auth Key is the base64-encoded combination of these two values (ConsumerKey:ConsumerSecret).
XPO APIs use OAuth 2.0. Once you have your credentials, a bearer token is generated by making a POST request to https://api.ltl.xpo.com/token with your username, password, and Basic Auth Key — Shipwell handles this automatically once your credentials are entered.
Forgot Your API Credentials?
There is no self-serve portal to retrieve XPO API credentials. If you have lost your Consumer Key, Consumer Secret, or Basic Auth Key, contact your XPO account representative to have them re-issued.
If you have only forgotten your User ID or Password, those can be reset through the standard XPO customer portal.
For API support, visit the XPO API Help Center.
Part 2 — Configure XPO in Shipwell
In Shipwell, navigate to the Carrier Profile for XPO.
Click the Accounts tab in the left margin.
Click Add Account.
Fill in the following:
Account Name (required) — give it a meaningful name (e.g. "XPO - Main").
Account Credentials (required) — enter your User ID, Password, Customer Number, and Basic Auth Key as prompted.
Modes (required) — select LTL (and any others that apply).
Origins — leave blank unless you need per-location routing with multiple accounts.
Destinations — leave blank for a single account.
Optional settings to consider:
Allow PRO # Assignment From Carrier — check this to auto-assign a PRO number at dispatch (recommended for LTL).
Bill To Terms — set if you want Prepaid, Collect, or 3rd Party applied automatically at dispatch.
Click Test Connection to validate your credentials before saving. A success message confirms Shipwell can reach the XPO API. If it fails, re-check your User ID, Password, Customer Number, and Basic Auth Key for typos.
Click Save.
Part 3 — Verify It is Working
Once saved, go to the Instant Rate Results screen on a shipment. You should see XPO rates appear with your account name displayed under the carrier logo. If rates do not return, double-check your credentials — particularly the Basic Auth Key and Customer Number.
Additional Resources