> ## 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.

# FedEx API

> Track FedEx parcels, create return and shipping labels, book return pickups, and check addresses and rates

The common use is hardware on a ticket: an agent reads the FedEx tracking number on the ticket, sees whether the parcel has shipped, is in transit, is held up or was delivered, and chases the user, stops chasing or notes the delivery. It can also create a new return label or have FedEx collect the device.

> [!NOTE]
>
> Automatically enabled when you configure FedEx permissions in your agent workflow, or on a dashboard.

## What It Does

* Track up to 30 parcels per call by tracking number, your reference or shipment, with status, scan events, delivery date and signature proof of delivery
* Create shipments with their labels, as a print link for the technician
* Create return labels that FedEx emails to the user, or that the technician prints
* Book FedEx return pickups (tags): FedEx brings the label and collects the parcel
* Cancel a label or a return pickup that was not used
* Validate addresses and postal codes, compare rates and transit times per service, and find FedEx locations
* Book and cancel pickups
* Read regulatory documents for international shipments, check dangerous goods, and upload trade documents
* Work with FedEx Freight LTL, consolidation and FedEx Returns, for accounts enrolled in them

## Permission Groups

| Group | Covers |
| - | - |
| Shipments & Labels | Create shipments with their labels, return labels emailed to the user or as a print link, and FedEx return tags; cancel them; Open Ship and the Ground end-of-day close |
| Tracking | Where a parcel is, its status, scan events, delivery date and signature proof of delivery. Have FedEx email tracking events to addresses |
| Rates, Transit Times & Addresses | Rates and transit times per service, address and postal code validation, service and packaging options, and FedEx locations. Read only |
| Pickups | Pickup availability. Book and cancel a FedEx pickup |
| Customs & Trade | Regulatory documents and advisories, dangerous goods checks and manifests. Upload trade documents, regulatory profiles and dangerous goods data with Read / Write |
| Freight & Programs | FedEx Freight LTL rates, shipments and pickups; consolidations; and FedEx Returns RMAs, items, labels and receipts |

## Access Profiles

| Profile | What runs on its own | What asks a technician |
| - | - | - |
| **Read Only** | Every read, tracking included | No write is allowed |
| **Helpdesk** | Every read | Labels, return pickups, cancels, pickups and tracking emails; no other write is allowed |
| **IT Admin** | Every read | Every write, in every group: each spends money or sends mail in your name |
| **Full Automation** | Every read and write | Nothing |

## Safety Controls

| Control | Behavior |
| - | - |
| **Your saved account number** | Neo writes the FedEx account number saved on the tile into every account-number field (`accountNumber`, `associatedAccountNumber`, the payer's account) and refuses any other value there, so no call bills another account |
| **No sign-in tokens or child keys** | Neo never sends FedEx's sign-in call or the account registration calls that return a project's keys |
| **Operations from the API reference only** | Neo sends only the operations in FedEx's API files; any other call is refused before it reaches FedEx |
| **Labels stay out of the conversation** | A base64 label or document is left out of what the agent reads; the agent gives people FedEx's label link |


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