# About FedEx® shipping

You can create FedEx® shipping labels for the service methods and packaging types listed in this document.

## FedEx® service methods supported

The following service methods are supported for FedEx:

- FedEx International Economy®
- FedEx International Ground®
- FedEx® International Connect Plus
- FedEx International Connect Tracked DDP
- FedEx International Connect Tracked DDU
- FedEx Standard Overnight®
- FedEx 2Day®
- FedEx 2Day® A.M.
- FedEx Home Delivery®
- FedEx First Overnight®
- FedEx Priority Overnight®
- FedEx Express Saver®
- FedEx Ground®
- FedEx International Priority® Express
- FedEx International First®
- FedEx International Priority®
- FedEx Economy®
- FedEx Ground® Economy
- FedEx Ground® Economy Bound Printed Matter
- FedEx Ground® Economy Media Mail
- FedEx Ground® Economy Returns
- FedEx Ground® Economy (under 1 lb.)
- FedEx® Electronic Trade Documents
- FedEx First Overnight® Extra Hours
- FedEx Standard Overnight® Extra Hours
- FedEx Priority Overnight® Extra Hours
- FedEx One Rate®. Additional details for using FedEx One Rate® are included in the [FedEx One Rate](https://docs.shipium.com/docs/fedex#fedex-one-rate) ® section of this document.

FedEx® Delivery Signature Options:

- No Signature Required
- Indirect Signature Required
- Direct Signature Required
- Adult Signature Required

FedEx's service methods and their identifiers are listed on the [Supported Carriers](https://docs.shipium.com/docs/supported-carriers#fedex) page.

## FedEx® packaging types supported

The following packaging types are supported for FedEx shipments:

- FedEx® Envelope
- FedEx® Pak
- FedEx® Box
- FedEx® Extra Small Box
- FedEx® Small Box
- FedEx® Medium Box
- FedEx® Large Box
- FedEx® Extra Large Box
- FedEx® Tube
- Your Packaging

_FedEx service marks are owned by Federal Express Corporation and are used by permission._

# Configure your FedEx account with Shipium

To configure your FedEx account within the Shipium platform, you'll first need to confirm the account number associated with your login. The [FedEx Log In homepage](https://www.fedex.com/secure-login/#/login-credentials) is where you'll log in to verify the account.

Next, you'll need to access the [Shipium Console](https://partner.shipium.com/login). From the navigation menu, you'll select **Configure** and then **FedEx Account Registration**.

You'll provide your FedEx account billing address and indicate your acceptance of the license agreement authorizing Shipium to access your FedEx account on your behalf. Once you've entered all the required information, you'll select the **Validate** button.

The next step is selecting the multi-factor authentication method preferred for the account. You can provide a past FedEx invoice, you can be sent a one-time PIN, or you can contact FedEx directly. If providing a past invoice, you'll enter the required data and select **Validate**.

If choosing the PIN method, you'll choose the way you wish to receive the PIN verification: via SMS text message, email, or phone call. You'll provide the seven-digit verification code once you have it.

If contacting FedEx, you'll call customer support and provide the required details to validate your identity and authorize your access and select **Validate** once you've completed the process.

Finally, you'll see the successful registration message in the console. With a successful registration, the values for your FedEx Child API Key and FedEx Child API Secret will auto populate.

# Billing options

FedEx supports multiple billing account types as well as billing multiple payor accounts separately for costs associated with a shipment. You can find information about billing options for FedEx in [Specifying Payors](https://docs.shipium.com/docs/specifying-payors#fedex-payor-information).

# Shipping options

## Declared value for packages

When shipping with FedEx, you may optionally declare a value for the package being shipped. The following FedEx service methods are available to declare a package value:

- FedEx Express Saver®
- FedEx Express Saver® - FedEx One Rate®
- FedEx First Overnight®
- FedEx Ground®
- FedEx Ground® - From Alaska
- FedEx Ground® - From Hawaii
- FedEx Ground® Economy
- FedEx Ground® Economy (under 1 lb.)
- FedEx Priority Overnight®
- FedEx Priority Overnight® - From Alaska
- FedEx Priority Overnight® - From Hawaii
- FedEx Priority Overnight® - FedEx One Rate®
- FedEx Priority Overnight® - FedEx One Rate® From Alaska
- FedEx Priority Overnight® - FedEx One Rate® From Hawaii

To declare a package value, you'll include the optional fields in the table below as part of the `shipmentParameters` in your API call.

| Request field | Details |
| --- | --- |
| `totalDeclaredValue.declaredValue` | **Type:** Number (float)<br>**Example:**`500`<br>**Description:** The value to be passed through as the total monetary amount of the declared value for the package. This is what will be reimbursed if the package is damaged. If the declared value exceeds the carrier's free threshold, there may be a surcharge for passing a declared value. |
| `totalDeclaredValue.currencyCode` | **Type:** String<br>**Example:**`usd`<br>**Description:** The currency code for the declared value |

A snippet of the JSON request for the API call with the optional declared value fields is included. This example is for a single-parcel shipment. The request fields for a [multi-parcel shipment](https://docs.shipium.com/docs/multi-parcel-shipments) would be included in `multiParcelShipmentParameters`.

```json
{
"shipmentParameters": {

"totalDeclaredValue": {
        "declaredValue": 5000,
        "currencyCode": "usd",
 ...
     }
}
```

## FedEx® Ground Economy (formerly SmartPost)

FedEx Ground® Economy, formerly referred to as FedEx SmartPost®, is a shipping method that requires you to provide an identification (ID) number for the FedEx processing hub located closest to your fulfillment center, or origin. You can find additional details about this service method in [FedEx's Ground Economy documentation](https://www.fedex.com/content/dam/fedex-com/hdn/FGE_ByPound_2026.pdf). For packages weighing 15.99 ounces or less, the FedEx Ground® Economy service method is rated on actual weight and is not subject to dimensional weight.

To configure your hub ID, navigate to **Configure > Fulfillment Contexts** in the [Shipium Console](https://partner.shipium.com/login) and select the relevant fulfillment context. Go to the **Contracts** tab, select your FedEx contract, and click **Add/Edit Carrier Account**. Scroll down to the **Service Method Credentials** section and select a FedEx Ground® Economy service method from the **Service Method** dropdown.

This will reveal the **FedEx SmartPost Hub ID** field, where you'll select your hub from a searchable dropdown listing hub IDs and their locations.

## FedEx International Connect (FIC)

FedEx International Connect (FIC) is a cost-effective international shipping service designed for lightweight, low-value e-commerce parcels. FIC uses consolidated customs clearance with final-mile delivery handled by destination postal services or local carriers, making it well suited for non-urgent business-to-consumer shipments where cost savings take priority over speed.

### FIC service methods

Shipium supports the following FIC service methods: FedEx International Connect Tracked DDP and FedEx International Connect Tracked DDU. Both service methods ship at the International One to Two Week service level.

#### DDP vs. DDU

The two FIC service methods differ in how duties and taxes are handled at the destination:

- **FedEx International Connect Tracked DDP.** _Delivered Duty Paid_. Duties and taxes are pre-paid by the shipper at the time of label creation. The recipient receives the package without owing any additional fees at delivery. DDP is available to approximately 150 destination countries.
- **FedEx International Connect Tracked DDU.** _Delivered Duty Unpaid_. Duties and taxes are the responsibility of the recipient and are collected at the time of delivery. DDU is available to 170+ destination countries with broad global coverage.

#### Package requirements

All FIC shipments must include weight and dimensions. FIC does not have a rating API — rates are based on offline rate tables configured in your Shipium account.

| Requirement | Limit |
| --- | --- |
| Maximum weight | 66 lb |
| Maximum combined length + girth | 98.4 in |
| Maximum length | 59 in |
| Dimensional weight divisor | 139 |

Billable weight is calculated as the greater of actual weight and dimensional weight, rounded up to the nearest pound.

### Customs requirements for FIC shipments

Incomplete or vague customs information can result in clearance delays or rejected shipments. The fields below are required for every FIC shipment and are included within `customsInfo` in the `shipmentParameters` of your API call.

#### Required fields

| Request field | Details |
| --- | --- |
| `customsInfo.incoterm` | **Type:** String<br>**Example:**`ddp`<br>**Description:** The incoterm for the shipment. Use `ddp` for FedEx International Connect Tracked DDP or `ddu` for FedEx International Connect Tracked DDU. |
| `customsInfo.totalCustomsValueCurrency` | **Type:** String<br>**Example:**`usd`<br>**Description:** The ISO 4217 currency code for the shipment's customs value. FIC uses a single currency for all items in the shipment. |
| `customsInfo.customsItems[].commodityDescription` | **Type:** String<br>**Example:**`Men's 100% Cotton Knitted T-Shirt`<br>**Description:** A specific, accurate description of the item. Generic values such as "Clothing," "Gift," or "Merchandise" are not accepted by FIC and will cause clearance delays. |
| `customsInfo.customsItems[].customsValue` | **Type:** Number (float)<br>**Example:**`18.31`<br>**Description:** The declared customs value for a single item. When multiple units are included, this is the per-unit value. Shipium uses the sum of all item values as the shipment-level customs total. |
| `customsInfo.customsItems[].countryOfManufacture` | **Type:** String<br>**Example:**`US`<br>**Description:** The 2-letter ISO [country code](https://docs.shipium.com/docs/non-us-address-formats#per-country-details) where the item was manufactured or produced. Required for duties and tax calculation across FIC trade lanes. |
| `customsInfo.customsItems[].quantity` | **Type:** Integer<br>**Example:**`3`<br>**Description:** The number of units of this item in the shipment |
| `customsInfo.customsItems[].productId` | **Type:** String<br>**Example:**`SKU-ABC-123`<br>**Description:** Your internal SKU or product identifier for the item. Used as the primary item identifier within the FIC network. |
| `customsInfo.customsItems[].harmonizedTariffNumber` | **Type:** String<br>**Example:**`6109100010`<br>**Recommended:** The Harmonized System (HS) tariff code for the item, 6–10 digits depending on the destination country. While not required, including a valid HS code reduces the risk of customs delays. |

#### Example request

The following is a JSON snippet showing the required customs fields for a single-item FIC shipment. This example is for a single-parcel shipment included within `shipmentParameters`.

```json
{
  "shipmentParameters": {
    "customsInfo": {
      "incoterm": "ddp",
      "totalCustomsValueCurrency": "usd",
      "customsItems": [
        {
          "harmonizedTariffNumber": "6109100010",
          "commodityDescription": "Men's 100% Cotton Knitted T-Shirt",
          "customsValue": 54.95,
          "countryOfManufacture": "CN",
          "quantity": 1,
          "productId": "SKU-ABC-123"
        }
      ]
    }
  }
}
```

## Hold at location

You may opt to designate a shipment as "hold at location", or HAL, if you'd like to have a package held for pickup at a FedEx location nearby rather than having it delivered to an address. To flag a package as HAL, you'll need to include the fields in the tables below as part of the `labelParameters` in your API call.

### Conditional fields

| Request field | Details |
| --- | --- |
| `holdAtLocation.useHoldAtLocation` | **Type:** Boolean<br>**Values:**`true` or `false`<br>**Condition:** Required to designate a package as "hold at location"<br>**Description:** If `true`, this indicates that the shipper wishes to have the package held at a FedEx location nearby for pickup rather than having it delivered. |

### Optional fields

| Request field | Details |
| --- | --- |
| `holdAtLocation.holdAtLocationId` | **Type:** String<br>**Example:**`USA 123`<br>**Description:** An optional identifier your organization can include to reference the package being held at location |

A snippet of the JSON request for the API call with the optional hold at location fields is included.

```json
{
"labelParameters": {

"holdAtLocation": {
        "useHoldAtLocation": true,
        "holdAtLocationId": "USA 123",
 ...
     }
}
```

## Lithium batteries and limited quantity shipments

When shipping limited quantity (LQ) lithium ion batteries via FedEx Ground services, including FedEx International Ground® to Canada, these shipments do not require full dangerous goods (DG) documentation. FedEx treats LQ lithium batteries as regular ground shipments rather than hazmat shipments.

### Request configuration

To ship LQ lithium ion batteries (UN3480) via FedEx International Ground, configure your API request with the following in `orderItemQuantities`:

**hazmat.** Set to `false`. Do not flag these shipments as hazmat.

**productDetails.** Include `[\