Skip to main content
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.
Important for Existing UsersIf you registered your FedEx BYOA account with Shippo prior to 01-14-2026 you must re-register your account before 3-31-2026 to avoid disruption. See the FedEx Reconnecting Your Account Guide for step-by-step instructions.
infoBefore 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

To select your verification medium, set verification_option to SMS, EMAIL, or CALL. The following example shows verification using SMS.
Connect account request
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"
    }
}'
Connect account response
{
  "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 account
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"
    }
}'
verify account response
{
  "object_id": "b741b99f95e841639b54272834bc478c",
  "carrier": "fedex",
  "account_id": "293235673",
  ...,
  "parameters": {
    "use_multi_factor_registration": true,
    "use_rest_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.
ParameterDescription
verification_invoice_numberThe invoice number from your FedEx invoice.
verification_invoice_dateThe date your invoice was issued.
verification_invoice_amountThe total charge quoted on your invoice.
verification_invoice_currencyThe currency (ISO currency code) quoted on your invoice.
Connect account with Invoice verification request
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"
    }
}'
Connect account with Invoice verification response
{
  "object_id": "a2e7c11d98f5436ba8e22338829ad577",
  "carrier": "fedex",
  "account_id": "293235673",    
  ...,
  "parameters": {
    "use_rest_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": "******"
  }
}
noteRegistration 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 image
curl -X POST \
https://api.goshippo.com/carrier_accounts/a2e7c11d98f5436ba8e22338829ad577/documents\
  -H "Authorization: ShippoToken <API_TOKEN>" \
  -H 'Content-Type: multipart/form-data' \
  -F 'document_type=LETTERHEAD' \
  -F 'file=@/path/to/your/letterhead.png'
Upload signature image
curl -X POST \
https://api.goshippo.com/carrier_accounts/a2e7c11d98f5436ba8e22338829ad577/documents\
  -H "Authorization: ShippoToken <API_TOKEN>" \
   -H 'Content-Type: multipart/form-data' \
  -F 'document_type=SIGNATURE' \
  -F 'file=@/path/to/your/signature.png'