FedEx Developer Guide and API Credentials

Overview

AfterShip Shipping is a FedEx Compatible Solution. Once you connect your FedEx shipper account to AfterShip Shipping, you can start creating shipments, generating labels, and getting live rates across AMEA, US, CA, and LAC regions, all from one place.

This guide walks you through connecting your FedEx account to AfterShip Shipping, the credentials you need, and the services available to you.

Before you begin

Make sure you have an active FedEx shipper account. If you do not have one, register for a FedEx shipper account before proceeding.

If you do not know your FedEx Shipping Address: Log in to your FedEx account, click your profile icon, select My Profile, and look under Contact Information.

Step 1: Start the connection in AfterShip Shipping

1. Log in to your AfterShip Shipping account.
2. Go to Carrier > Carrier accounts in the left sidebar.
3. Click Add carrier and select FedEx.

Step 2: Accept the FedEx End-User License Agreement (EULA)

Scroll through the FedEx End-User License Agreement, select the checkbox confirming you have read and accept it, and click Next.

Step 3: Enter your account details

1. Enter your FedEx account number and shipping address. The address must exactly match what is on file with FedEx.

Important: If the address does not match your FedEx profile, the system will trigger an Account address mismatch error. Double-check your details in your FedEx account before proceeding.

2. Click Next.

Step 4: Complete multi-factor authentication (MFA)

Select how you wish to verify your identity. You can receive a PIN via:

• Email
• SMS
• Phone call
• Invoice (from the past 90 days)

Enter the PIN or invoice details when prompted and click Verify.

Note: Some FedEx accounts are exempt from the MFA step and will proceed automatically after address validation. Contact your FedEx account manager if you are unsure which applies to you.

Step 5: Configure additional settings

Before finishing, you can configure the following optional settings. These can also be updated later from the carrier account settings page.

• Preferred currency: Specify an ISO 3 currency code (e.g., USD, GBP) to receive shipping rates in your preferred currency. Defaults to the currency of your FedEx account.
• Electronic Trade Documents (ETD): Enable ETD if you ship internationally and want to submit customs documents electronically.
• Letterhead and signature: Upload your commercial_invoice_letterhead (PNG, max 700 × 50 px) and commercial_invoice_signature (PNG, max 240 × 25 px) if ETD is enabled.

Click Submit to complete the connection.

Note: Once your FedEx account is connected, the account number and address cannot be edited in AfterShip Shipping. FedEx locks these details at setup to ensure they match their records. If your information changes with FedEx, reconnect your account to reflect the updates.

Create a FedEx account via API

If you prefer to connect your FedEx account programmatically, use the following endpoint:

Endpoint:

POST https://api.aftership.com/postmen/v3/couriers/fedex/shipper-accounts

Request example:

{
  "slug": "fedex",
  "invoice": {
    "number": "234562278",
    "currency": "USD",
    "date": "2026-02-24",
    "amount": 234
  },
  "credentials": {
    "account_number": "11111111"
  },
  "address": {
    "country": "USA",
    "contact_name": "Test name",
    "phone": "14158523888",
    "fax": null,
    "email": "[email protected]",
    "company_name": null,
    "street1": "15 W 18TH ST FL 7",
    "street2": null,
    "city": "NEW YORK",
    "state": "NY",
    "postal_code": "100114624",
    "type": "residential",
    "tax_id": null
  },
  "settings": {
    "preferred_currency": "USD",
    "commercial_invoice_letterhead": "xxxx",
    "commercial_invoice_signature": "xxxx"
  }
}

Notes:

• An invoice from the past 90 days is required for MFA validation.
• credentials, address, and preferred_currency are optional but recommended to ensure accurate validation against your FedEx records.
• To enable ETD, include both commercial_invoice_letterhead and commercial_invoice_signature in the settings object.
• You can also create a FedEx Ground® Economy account using the same endpoint by setting "slug": "fedex-smartpost".
• After account creation, you can update commercial_invoice_letterhead and commercial_invoice_signature at any time using: https://api.aftership.com/postmen/v3/shipper-accounts/{id}/settings

Required FedExAPI credentials

Things to know before generating labels

To avoid label failures, make sure your shipment data meets the following requirements:

Supported FedEx services

Standard services

One rate services

Regional services

FedEx Ground® Economy

Note on FedEx Ground® Economy labels: Return labels support QR code generation. Include print_options.qr_code in your API request for return shipments to retrieve the QR code file. Labels also now return transit_time and delivery_date for better delivery estimates.

FedEx Developer Resources

• Read FedEx docs
• AfterShip Shipping FedEx technical support: [email protected]

Updated on: 22/05/2026