1.0.0

First public release of the FedEx integration — track your FedEx parcels in Home Assistant.

FedEx offers no anonymous tracking a script is allowed to use, so this is the first integration in the family that asks for a key of your own: a free FedEx developer project gives you an API Key and a Secret Key, and those make tracking possible at all. You enter them once when you add the integration.

New features

• Track any number of FedEx parcels by tracking number, through FedEx's official tracking API with your own developer key
• Per-parcel sensor with the canonical status (registered / in_transit / out_for_delivery / delivered / …), FedEx's own status text and the location of the latest scan
• Summary sensors: incoming parcels, parcels waiting to be collected, recently delivered parcels, and a diagnostic last-update sensor
• Parcel weight and size, in kilograms and centimetres — FedEx reports both imperial and metric, and the metric values are used
• fedex.track_parcel / fedex.untrack_parcel services, so a dashboard button can add a parcel
• Events and device triggers for no-code automations (parcel registered, status changed, delivered)
• Opt-in per-parcel status history
• Manual refresh button
• Home Assistant asks you for a new key if FedEx ever stops accepting the stored one, instead of quietly failing
• Available in 30 languages
• Part of the ha-parcel-integrations family: the same canonical parcel format, statuses and events as the other carrier integrations, so it plugs straight into the Parcel Aggregator and cross-carrier automations

Why 1.0.0

Confirmed against eleven real parcels on a real FedEx developer project. Every status they reported — label created, picked up, in transit, held for collection, clearance delay, delivery exception and delivered — maps onto a canonical status, and an unfamiliar one shows as unknown and logs a one-time warning with a ready-made issue link.

FedEx can label a parcel it has already collected as "ready for pickup" in its summary view. The specific status wins, so such a parcel reads as in transit here, the same as on FedEx's own website.

Known limitations

• No parcel has yet reported an expected delivery window, so the next delivery sensor and the Deliveries calendar stay empty. FedEx does publish a separate commitment date, but that is a promise rather than a delivery window, so it is deliberately not shown as one.
• Parcels are fetched one request at a time. FedEx allows up to 30 per request, which would be gentler on your key's quota if you track many parcels.

🙋 2 open questions need a real parcel to answer

---

📦 See every supported carrier — new ones land regularly.
💛 Support the project