A complete step-by-step checklist to ensure your migration to the FedEx REST API integration is fully configured and production-ready.


Complete all steps before 30 April 2026



How to Use This Checklist


Work through each section in order. Do not skip sections, as some steps depend on earlier ones being in place. If you run into any issues, refer to the linked guides or contact Linnworks Technical Support.



1. Add the (New) FedEx Integration

  • Navigate to Shipping > Integrations > Add Integration
  • Locate (New) FedEx in the integrations list and click Integrate.
  • Complete authentication (PIN or Invoice)
  • Confirm the integration is active


2. Review Integration-Level Configuration


Once the integration is created, reopen its configuration by clicking the Config button on the (New) FedEx integration. The following additional options will now be available and should be reviewed:

  • Return Address Details
  • Account Settings (Address Validation)
  • Additional Documents
  • Quote Details
  • Masked Data


3. Add and Configure Services

If you created services from scratch rather than linking

You will need to manually update the Rules Engine and Channel Shipping Mapping to reference the new service names. See Section 6 for details.
  • Review and configure each service's settings


4. Check Order and Item Property Mapping


Property names may have changed

Some order and item property names used in the legacy FedEx Web Services integration have changed in the new REST API integration. Review all mappings carefully to ensure data is still being passed correctly.


  • Review Item Property mappings
  • Review Order Property mappings
  • Review Packaging mappings


5. Check Printer Template


Verify the correct thermal printer is mapped under (New) FedEx > Printer Config and the correct template type is selected.


6. Rules Engine & Channel Shipping Mapping


Note: Only required if services were created from scratch


If you linked your services from the old integration, your existing rules and channel mappings will continue to work. This section only applies if you created new services from scratch rather than linking.


  • Update the Rules Engine

Go to Orders > Rules Engine and review any rules that reference FedEx services by name. Update these to use the new service names from the (New) FedEx integration.


  • Update Channel Shipping Mapping

Go to Settings > Channel Integration > Channel Shipping Mapping and update any FedEx service mappings that reference the old integration's service names. Ensure each channel's shipping method is correctly mapped to the new service.


7. Review Vendor Name on Postal Services


Note: Newly added services use "(New) FedEx" as the Vendor name.


Services added through the new integration will automatically be assigned "(New) FedEx" as the Vendor name. This may affect tracking URL formatting or the Vendor name displayed on despatch notes.


To update the Vendor name:

  • Go to Shipping > Postal Services.
  • Locate the relevant service and double-click the Vendor name.
  • Remove the (New) prefix and save.


8. Final Checks Before Go-Live

  • Process a test shipment end-to-end (Generate a label through the new integration, confirm it prints correctly, and verify tracking information is returned as expected).
  • Confirm despatch notes and documentation are correct (Check that despatch notes display the correct Vendor name, tracking details, and any required customs or trade documents).
  • Remove old FedEx Web Services services.
  • Migration complete


For further guidance, see the FedEx Migration FAQ or the Service Linking guide. Contact Linnworks Technical Support if you need assistance.