FedEx

To protect your account security, FedEx require two-factor authentication when connecting your own FedEx to Shippo. This means you must verify your identity before you can start using your FedEx account. Follow this guide to understand how to connect your own FedEx account to Shippo.

info

Before you begin, this guide assumes you have already created your own FedEx account.

You can use any of the following methods to verify your account.

  • SMS
  • EMAIL
  • INVOICE
  • CALL

Connect your own FedEx account using SMS, EMAIL, or CALL Verification

Using SMS, EMAIL, or CALL verification, FedEx will send you a verification PIN to your chosen medium. You will then use this pin to verify your identity.

Connect your account using SMS, EMAIL, or CALL

Top select your verification medium, set verification_option to SMS, EMAIL, or CALL.

The following example shows verification using SMS.

Connect account requestConnect account response
Copy
Copied
curl -X POST \
  https://api.goshippo.com/carrier_accounts \
  -H "Authorization: ShippoToken <API_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{
    "carrier": "fedex",
    "account_id": "293235673",
    "parameters": {
      "use_multi_factor_registration": true,
      "first_name": "Tom",
      "last_name": "Monk",
      "phone_number": "1234567890",
      "from_address_st": "20 FED EX PKWY",
      "from_address_city": "Beverly Hills",
      "from_address_state": "CA",
      "from_address_zip": "90210",
      "from_address_country_iso2": "US",
      "verification_option": "SMS"
    }
}'
Copy
Copied
{
  "object_id": "b741b99f95e841639b54272834bc478c",
  "carrier": "fedex",
  "account_id": "293235673",
  "parameters": {
    "use_multi_factor_registration": true,
    "first_name": "Tom",
    "last_name": "Monk",
    "phone_number": "1234567890",
    "from_address_st": "20 FED EX PKWY",
    "from_address_city": "Beverly Hills",
    "from_address_state": "CA",
    "from_address_zip": "90210",
    "from_address_country_iso2": "US", 
    "verification_option": "SMS",
    "verification_status": "PENDING"
  }
}

Verify your account using PIN

To complete connecting your FedEx account, you must verify your account using a PIN number. You will receive an SMS from FedEx that includes your verification PIN number. This PIN will be sent to the number you provided to FedEx during your account registration. Pass this number to verify your account using verification_pin.

Verify accountverify account response
Copy
Copied
curl -X PUT \
  https://api.goshippo.com/carrier_accounts/b741b99f95e841639b54272834bc478c \
  -H "Authorization: ShippoToken <API_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{
    "carrier": "fedex",
    "account_id": "293235673",
    "parameters": {
      "use_multi_factor_registration": true,
      "first_name": "Tom",
      "last_name": "Monk",
      "phone_number": "1234567890",
      "from_address_st": "20 FED EX PKWY",
      "from_address_city": "Beverly Hills",
      "from_address_state": "CA",
      "from_address_zip": "90210",
      "verification_option": "SMS",
      "verification_pin": "123456"
    }
}'
Copy
Copied
{
  "object_id": "b741b99f95e841639b54272834bc478c",
  "carrier": "fedex",
  "account_id": "293235673",
  ...,
  "parameters": {
    "use_multi_factor_registration": true,
    "use_oauth_api": true,
    "first_name": "Tom",
    "last_name": "Monk",
    "phone_number": "1234567890",
    "from_address_st": "20 FED EX PKWY",
    "from_address_city": "Beverly Hills",
    "from_address_state": "CA",
    "from_address_zip": "90210",
    "verification_option": "SMS",
    "verification_status": "COMPLETE", 
    "child_key": "******",
    "child_secret": "******"
  }
}

Connect your own FedEx account using INVOICE Verification

The INVOICE verification uses details from a recent invoice receive from FedEx to verify your identify.

Connect account using INVOICE

The following example requires a recent FedEx invoice. In addition to some personal details you will require the following items.

Parameter Description
verification_invoice_account_number Your FedEx account number referenced on your invoice.
verification_invoice_date The date your invoice was issued.
verification_invoice_amount The total charge quoted on your invoice.
verification_invoice_currency The currency (ISO currency code) quoted on your invoice.
Connect account with Invoice verification requestConnect account with Invoice verification response
Copy
Copied
curl -X POST \
  https://api.goshippo.com/carrier_accounts \
  -H "Authorization: ShippoToken <API_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{
    "carrier": "fedex",
    "account_id": "293235673",
    "parameters": {
      "use_multi_factor_registration": true,
      "first_name": "Tom",
      "last_name": "Monk",
      "phone_number": "1234567890",
      "from_address_st": "20 FED EX PKWY",
      "from_address_city": "Beverly Hills",
      "from_address_state": "CA",
      "from_address_zip": "90210",
      "from_address_country_iso2": "US",
      "verification_option": "INVOICE",
      "verification_invoice_number": "293235673",
      "verification_invoice_date": "2022-10-09",
      "verification_invoice_amount": "2323.22",
      "verification_invoice_currency": "USD"
    }
}'
Copy
Copied
{
  "object_id": "a2e7c11d98f5436ba8e22338829ad577",
  "carrier": "fedex",
  "account_id": "293235673",    
  ...,
  "parameters": {
    "use_oauth_api": true,
    "use_multi_factor_registration": true,
    "first_name": "Tom",
    "last_name": "Monk",
    "phone_number": "1234567890",
    "from_address_st": "20 FED EX PKWY",
    "from_address_city": "Beverly Hills",
    "from_address_state": "CA",
    "from_address_zip": "90210",
    "from_address_country_iso2": "US",
    "verification_option": "INVOICE",
    "verification_invoice_number": "293235673",
    "verification_invoice_date": "2022-10-09",
    "verification_invoice_amount": "2323.22",
    "verification_invoice_currency": "USD",
    "child_key": "******",
    "child_secret": "******"
  }
}
note

Registration using INVOICE is a single step process. You are not required to verify the registration.

Commercial invoice letterhead and signature document upload

Although not required, FedEx highly recommends uploading letterhead and signature images that will be added to your commercial invoices. This can help avoid regulatory or customs delays with your shipment.

Your images must follow these rules.

  • Your letterhead image file must be in either GIF or PNG format and no larger than 700 pixels wide by 50 pixels high.
  • Signature images must be in either GIF or PNG format and no larger than 240 pixels wide by 25 pixels high.
Upload letterhead imageUpload signature image
Copy
Copied
curl -X POST \
https://api.goshippo.com/carrier_accounts/a2e7c11d98f5436ba8e22338829ad577/document\
  -H "Authorization: ShippoToken <API_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{
    "document_type": "LETTERHEAD",
    "file":"https://path-to-your-letterhead-file"
  }'
Copy
Copied
curl -X POST \
https://api.goshippo.com/carrier_accounts/a2e7c11d98f5436ba8e22338829ad577/documents\
  -H "Authorization: ShippoToken <API_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{
    "document_type": "SIGNATURE",
    "file":"https://path-to-your-signature-file"
  }'