Connecting a Carrier Account to ShipGenius

ShipGenius lets you connect your own carrier accounts for USPS, UPS, FedEx, and DHL so you can generate labels using your negotiated rates directly from your workspace. This article walks through how to connect each carrier, manage existing accounts, and troubleshoot common issues.

Getting Started

Navigate to the Carriers page using the left-hand menu. At the top of the page you'll find the Connect a Carrier Account section, where each supported carrier is listed. Connected accounts appear below in the Connected Carrier Accounts section.

Connecting USPS

USPS is connected via a secure OAuth authorization flow through USPS directly — you don't enter credentials manually.

• Click the Authorize button under the USPS logo.
• You'll be redirected to USPS to log in and approve the connection.
• Once authorized, your USPS account will show as Connected on the Carriers page.

If you've previously authorized USPS but haven't completed your account setup, you'll see an Add USPS Account Info prompt instead. Complete that step to finish connecting.

USPS Troubleshooting

• To disconnect USPS, click Log out of USPS. This action is restricted to admins.
• If authorization fails, try the flow again. If the issue persists, contact support.

Connecting UPS, FedEx, or DHL

UPS, FedEx, and DHL are connected by entering your account credentials directly into ShipGenius.

• Click the Add account card for the carrier you want to connect.
• A modal will appear prompting you to enter your Account Number, Client ID, and Client Secret.
• Click Connect Account. ShipGenius will validate your credentials and add the account to your Connected Carrier Accounts list.

You can connect multiple accounts per carrier if needed — for example, separate UPS accounts for different warehouse locations.

Managing Connected Accounts

Each connected carrier account is displayed with its logo, account number, and current status. From the connected accounts list you can:

• Edit credentials — click the account to open the modal and update your Account Number, Client ID, or Client Secret.
• Test connection — verify that your saved credentials are still valid.
• Delete the account — removes the carrier account from ShipGenius. This action is restricted to admins.

FAQs

Where do I find my UPS Client ID and Client Secret?

Your UPS Client ID and Client Secret come from the UPS Developer Portal at developer.ups.com. You'll need to create an app there if you haven't already — the credentials are generated when you set up API access for your UPS account.

Where do I find my FedEx credentials?

FedEx API credentials are available through the FedEx Developer Portal at developer.fedex.com. Create a project under your FedEx account to generate your Client ID and Client Secret.

Where do I find my DHL credentials?

DHL API credentials are available through the DHL Developer Portal at developer.dhl.com. You'll need an active DHL business account to generate API access.

Can I connect more than one account for the same carrier?

Yes. You can add multiple accounts per carrier. Each account is listed separately under Connected Carrier Accounts and can be managed independently.

Who can delete or disconnect carrier accounts?

Deleting a carrier account and logging out of USPS are admin-only actions. Other workspace members can view and use connected accounts but cannot remove them.

What if my credentials stop working?

Carrier API credentials can be rotated or revoked on the carrier's end without notice. If a previously working account shows an error, open the account modal and re-enter your current credentials. Use the test connection option to confirm they're valid before saving.

Need Help?

If you're having trouble connecting a carrier account or your credentials aren't being accepted, reach out to support at support@shipgenius.com. Include the carrier you're connecting, the email address on your ShipGenius account, and a screenshot of any error message you're seeing.