> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting FedEx to Neo

> Create a FedEx Developer Portal project and save its API Key, Secret Key and your account number in Neo

You connect FedEx once at the MSP level, with a project in the FedEx Developer Portal that is linked to your FedEx shipping account.

## 1. Create the project in the FedEx Developer Portal

**1. Sign in**

Go to [developer.fedex.com](https://developer.fedex.com) and sign in with the fedex.com user ID that manages your shipping account.

**2. Create the project**

Open **My Projects** and click **Create API Project**. Choose that you ship with FedEx for your own business, and link the FedEx account number the labels and pickups bill to.

**3. Add the APIs**

Add at least **Track API**. Add **Ship API**, **Pickup Request API**, **Address Validation API**, **Rates and Transit Times API** and **Service Availability API** if your agents create labels or book pickups. A call to an API the project does not hold fails with an authorization error.

**4. Copy the production keys**

Open the project's **Production Key** and copy its **API Key** and **Secret Key**. The test keys reach FedEx's sandbox only and do not work in Neo. Keep the secret out of email and chat. FedEx may ask you to finish its label review before the Ship API works with production keys; tracking works without it.

Your FedEx account number is the nine digits of your shipping account, such as `123456789`. It is on your FedEx invoices and under My Profile on fedex.com, and it must be linked to the project.

Neo signs in at `https://apis.fedex.com` with the API Key and Secret Key, and bills each label and pickup to the account number you save.

## 2. Add FedEx in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the FedEx card, under Other.

**2. Save the keys**

Enter the API Key, the Secret Key and your FedEx account number, and click **Save settings**. Neo signs in to FedEx before saving, so a wrong API Key or Secret Key is rejected straight away.

## 3. Turn FedEx on per agent

Open the agent, go to the Integrations section, and pick an access profile for the FedEx block, or set each area yourself:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Shipments & Labels** | Disabled, Read Only, Read / Write | Creating and cancelling labels and FedEx return pickups needs Read / Write. |
| **Tracking** | Disabled, Read Only, Read / Write | Tracking needs Read Only. Read / Write has FedEx email tracking events to addresses. |
| **Rates, Transit Times & Addresses** | Disabled, Read Only | Address checks, rates and transit times. |
| **Pickups** | Disabled, Read Only, Read / Write | Booking and cancelling pickups needs Read / Write. |
| **Customs & Trade** | Disabled, Read Only, Read / Write | Regulatory documents, dangerous goods and trade document uploads. |
| **Freight & Programs** | Disabled, Read Only, Read / Write | Only for accounts enrolled in FedEx Freight LTL, consolidation or FedEx Returns. |

To chase returns and follow up deliveries, Tracking at Read Only is enough. See [FedEx](https://docs.neoagent.io/integrations/fedex/overview.md) for what to put in the agent's instructions, and [FedEx API](https://docs.neoagent.io/agents/tools/management/fedex-api.md) for the profiles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.