How to Connect Your FedEx Account to Hopstack

This guide provides step-by-step instructions on how to integrate your FedEx account with Hopstack for shipping label generation and tracking.

What You'll Need

Before you begin:

• An active FedEx business account

• Admin access to Hopstack with Integration Management permissions

• Your FedEx account username and password

Part 1: Create Your FedEx Developer Account

Step 1: Go to FedEx Developer Portal

Visit developer.fedex.com and log in with your FedEx business account credentials.

Step 2: Create a Project

1. Click on "My Projects"

2. Click "Create a Project"

3. Name your project (e.g., "Hopstack Integration")

4. Select Shipping APIs when asked which APIs you need

Step 3: Get Your API Credentials

1. Go to "API Keys" in your project

2. Generate Test Credentials first for testing

3. Save your:

   • Test Client ID

   • Test Secret Key

   • Test Account Number

Important: You'll need Production Credentials later for live shipping. See the guide on How to Obtain Production Keys.

Part 2: Connect FedEx to Hopstack

You can connect FedEx at two levels:

• Client-Level - For a specific warehouse and client

• Global - To use across multiple clients

Option A: Client-Level Integration

Step 1: Open Integration Management

1. Log in to Hopstack

2. Go to Setup → Integration Management

Step 2: Select Your Warehouse and Client

Select the appropriate warehouse and client from the dropdown menus.

Step 3: Connect FedEx

1. Find FedEx in the integrations list

2. Click Connect

Step 4: Enter Your Details

Fill in the form:

• Account Name - A name to identify this account (e.g., "FedEx Main")

• Client ID - From FedEx Developer Portal

• Secret Key - From FedEx Developer Portal

• FedEx Account Number - Your FedEx business account number

Step 5: Save

Click Submit. You'll see a success notification.

Option B: Global Integration

Step 1: Open Integration Management

1. Log in to Hopstack

2. Go to Setup → Integration Management

Step 2: Switch to Global Tab

Click the Global tab at the top.

Step 3: Manage FedEx

1. Find FedEx in the list

2. Click Manage

3. Click Connect New Account

Step 4: Enter Your Details

Fill in the form:

• Account Name - A name to identify this account (e.g., "FedEx Account 1")

• Client ID - From FedEx Developer Portal

• Secret Key - From FedEx Developer Portal

• FedEx Account Number - Your FedEx business account number

Step 5: Save

Click Submit. You'll see a success notification.

Adding More Accounts

To add additional FedEx accounts (Global only):

1. Go to Setup → Integration Management → Global

2. Find FedEx and click Manage

3. Click Connect New Account

4. Enter the new account details

5. Click Submit

Moving to Production

Important: Test credentials only work in sandbox mode. To create real shipping labels, you need Production credentials.

Follow our guide: How to Obtain FedEx Production Keys and Complete Label Validation

This process includes:

1. Requesting Production API credentials from FedEx

2. Generating and printing test labels

3. Submitting labels to FedEx for validation

4. Waiting for approval (3 business days)

5. Updating Hopstack with Production credentials

Why is this needed? FedEx requires label validation to ensure your labels meet their quality standards before you can ship real packages.

Next Steps

After connecting your FedEx account:

1. Test the Connection - Verify the integration appears as active

2. Configure Shipping Settings - Set up service types and label preferences

3. Create a Test Shipment - Generate a test label to confirm everything works

Need Help?

• Hopstack Support: Contact your Implementation Engineer or Customer Success Manager

• FedEx API Issues: Visit the FedEx Developer Portal support section

• Integration Problems: Submit a support ticket through Hopstack

Note: Start with Test credentials to verify everything works, then move to Production credentials for live shipping.