Integrate InPost parcel locker (APM) delivery for ecommerce shipments using the InPost API

Steps

1. Register for InPost API access and obtain a Bearer token; for the UK market use the InPost UK API (base URL api-uk.easypack24.net/v4); for the global API use OAuth 2.0 via the /oauth/token endpoint as documented at developers.inpost-group.com.
2. At checkout, call the APM Locations API to find available parcel lockers near the customer's chosen postcode or GPS coordinates; display locker options with addresses and opening hours.
3. When the customer selects a locker, capture the machine_id or locker identifier; pass it in the parcel creation POST request along with sender details, recipient phone number, parcel size (A, B, or C), and the chosen machine_id as the delivery point.
4. The API returns a parcel ID and tracking number; generate and provide the shipping label via the label download endpoint and affix it to the parcel.
5. Track parcel status using the InPost tracking API or tracking webhooks; key status transitions include dispatched, at_locker, ready_for_pickup, collected_by_recipient, and return_initiated.
6. Handle undelivered parcels: if the recipient does not collect within the pickup window (typically 48–72 hours), InPost returns the parcel to the sender; subscribe to return-initiated events to trigger your returns workflow.