FedEx

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® Delivery Signature Options:

FedEx's service methods and their identifiers are listed on the Supported Carriers page.

FedEx® packaging types supported

The following packaging types are supported for FedEx shipments:

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 is where you'll log in to verify the account.

Next, you'll need to access the Shipium Console. 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.

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:

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)
Example:500
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
Example:usd
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 would be included in multiParcelShipmentParameters.

{
"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. 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 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:

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
Example:ddp
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
Example:usd
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
Example:Men's 100% Cotton Knitted T-Shirt
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)
Example:18.31
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
Example:US
Description: The 2-letter ISO country code where the item was manufactured or produced. Required for duties and tax calculation across FIC trade lanes.
customsInfo.customsItems[].quantity Type: Integer
Example:3
Description: The number of units of this item in the shipment
customsInfo.customsItems[].productId Type: String
Example:SKU-ABC-123
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
Example:6109100010
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.

{
  "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
Values:true or false
Condition: Required to designate a package as "hold at location"
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
Example:USA 123
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.

{
"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 `[\