FedEx

Ensure your FedEx account is registered and verified, and create FedEx shipping labels.

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 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 About FedEx One Rate section of this document.

FedEx also offers the following delivery signature options:

  • No Signature Required
  • Indirect Signature Required
  • Direct Signature Required
  • Adult Signature Required

In addition, these home delivery options are available:

  • FedEx Date Certain Home Delivery®
  • FedEx Evening Home Delivery®
  • FedEx Appointment Home Delivery®

FedEx packaging types supported

The following packaging types are supported for FedEx shipments:

  • FedEx® Envelope
  • FedEx® Pak
  • FedEx® 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.

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® - One Rate
  • FedEx First Overnight®
  • FedEx Ground®
  • FedEx Ground® - From Alaska
  • FedEx Ground® - From Hawaii
  • FedEx Ground® Economy
  • FedEx Ground® Economy - Lightweight
  • FedEx Priority Overnight®
  • FedEx Priority Overnight® - From Alaska
  • FedEx Priority Overnight® - From Hawaii
  • FedEx Priority Overnight® - One Rate
  • FedEx Priority Overnight® - One Rate From Alaska
  • FedEx Priority Overnight® - 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.

Reference fieldRequired/OptionalField propertiesDescription
totalDeclaredValue .declaredValueOptionalNumber ($float)
Example: 500
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 .currencyCodeOptionalString
Example: USD
The currency code for the declared value

A snippet of the JSON request for the API call with the required fields is included. This example is for a single-parcel shipment. A multi-parcel shipment would be included in multiParcelShipmentParameters.

{
"shipmentParameters": {

   "totalDeclaredValue": {
        "declaredValue": 5000,
        "currencyCode": "USD",
 ...
     }
}

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.

About FedEx One Rate®

FedEx One Rate is a flat-rate shipping option that lets your organization ship packages that weigh 50 pounds or less to anywhere in the U.S. for a fixed price. This shipping method does not include dangerous goods. You can find more details about this shipping method in FedEx's One Rate documentation.

Shipium supports selection of the One Rate shipping method. To select a One Rate method for a shipment, you'll designate the shipping method in your calls to Shipium's Carrier and Method Selection and Label Service APIs. First, though, you'll need to set up a carrier contract for the FedEx One Rate in the Shipium Console.

The rest of this document provides guidance for how to configure your account for FedEx One Rate shipping and select a FedEx One Rate shipping method.

Configure FedEx One Rate for your account

To start using FedEx One Rate within the Shipium platform, you'll need to set up your account in the Shipium Console to include applicable FedEx One Rate service methods. You can find instructions for establishing a fulfillment context for your organization and attaching a carrier service method and rate to that context in the Fulfillment Contexts documentation.

Specifically, once you have configured a fulfillment context with an origin (or fulfillment center), you'll follow the guidance in the Carrier Contracts documentation to establish carrier contracts, accounts, and rates. The carrier rates configuration is where you'll select the FedEx One Rate service methods applicable to your account.

Within the carrier rate workflow, you'll select the carrier service method to associate with the carrier rate from a dropdown menu, as shown in the following screenshot.

After completing this configuration, you can designate FedEx One Rate as your shipping method.

Designate FedEx One Rate as your shipping method

As part of the shipment parameters of an API call, you'll provide one of the seven FedEx One Rate service methods as the shipment's packaging material, as part of the packaging type.

The following is a snippet of a JSON request call to Shipium's APIs. The minimum required fields for successfully selecting a FedEx One Rate delivery method are included in the sample request and are defined in the table below, which also includes optional fields that you may include in your call.

You can find information about package dimensions and FedEx One Rate service methods in FedEx's One Rate documentation.

"packagingType": {
        "packagingMaterial": "fedex_one_rate_small_box",
      },
      "totalWeight": {
        "weightUnit": "lb",
        "weight": 50
FieldRequired / OptionalTypeDescription
shipmentParameters .packagingType .packagingMaterialRequiredString
Values can be:

- fedex_one_rate_envelope
- fedex_one_rate_extra_large_box
- fedex_one_rate_large_box
- fedex_one_rate_medium_box
- fedex_one_rate_pak
- fedex_one_rate_small_box
- fedex_one_rate_tube
The applicable FedEx One Rate service method should be included as the packagingMaterial value.
shipmentParameters .packagingType .totalWeight .weightUnitRequiredString
Weight units include:

- g (gram)
- kg (kilogram)
- lb (pound)
- oz (ounce)
The unit in which weight values are provided
shipmentParameters .packagingType .totalWeight.weightRequiredNumber ($float)
Example: 50
The value of the weight. Weights are limited to 10 pounds for envelopes and 50 pounds for boxes using the FedEx One Rate service methods.
shipmentParameters .packagingType .packagingSizeNameOptionalString
Example: 13x12x10 Box
A custom name for the packaging
shipmentParameters .packagingType .packagingTypeIdOptionalString
Example: ebd94f8b-d390-4c9c-987f-b88343f5bf45
The packagingTypeId that was used for this package. When this value is present, the dimensions defined in the partner are used. When this value is absent, linearDimensions is required.
shipmentParameters .packagingType .linearDimensions .linearUnitOptional, but required if the packagingTypeId is not includedString
Values include:

- cm (centimeter)
- in (inch)
The unit in which linear dimensions are provided
shipmentParameters .packagingType .linearDimensions .lengthOptional, but required if the packagingTypeId is not includedNumber ($float)
Example: 13
The longest linear dimension (i.e., the longest side of a box or envelope)
shipmentParameters .packagingType .linearDimensions .widthOptional, but required if the packagingTypeId is not includedNumber ($float)
Example: 12
The second longest linear dimension (i.e., the second longest side of a box or envelope)
shipmentParameters .packagingType .linearDimensions .heightOptional, but required if the packagingTypeId is not includedNumber ($float)
Example: 10
The least long linear dimension (i.e., the shortest side of a box or envelope). Note on envelopes: This height should represent the highest product you would reasonably put in this envelope before losing more than 10% of the length of the envelope in other dimensions.
shipmentParameters .packagingType .packagingWeight .weightUnitOptionalString
Weight units include:

- g (gram)
- kg (kilogram)
- lb (pound)
- oz (ounce)
The unit in which weight values are provided
shipmentParameters .packagingType .packagingWeight .weightOptionalNumber ($float)
Example: 50
The value of the weight

The sample snippet from the JSON request would look like this if you included the optional fields referenced in the table above. If you choose not to provide the optional fields in your API call, they will be autofilled.

"packagingType": {
        "packagingMaterial": "fedex_one_rate_small_box",
        "packagingSizeName": "13x12x10 Box",
        "packagingTypeId": "ebd94f8b-d390-4c9c-987f-b88343f5bf45",
        "linearDimensions": {
          "linearUnit": "in",
          "length": 13,
          "width": 12,
          "height": 10
        },
        "packagingWeight": {
          "weightUnit": "lb",
          "weight": 50
        }
      },
      "totalWeight": {
        "weightUnit": "lb",
        "weight": 50

About 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 guidance for providing your hub ID in the Carrier Contracts documentation.

FAQ

Q: Can I use FedEx Ground shipping as part of the FedEx One Rate?
A: No. FedEx Ground shipping is not available with FedEx One Rate pricing.


Q: Will there be additional surcharges, like fuel, added to my invoice if I use FedEx One Rate shipping methods?
A: Additional surcharges can apply. The FedEx One Rate documentation provides details.


Q: Can I ship hazardous materials (hazmat) via FedEx One Rate methods?
A: No. Because dangerous goods cannot be shipped in FedEx Express packaging, FedEx One Rate is not available. The FedEx One Rate documentation provides details.

Resources

Your Shipium team member is available to help along the way. However, you might find these resources helpful: