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.
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.
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.
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.
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.
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.
Known gotchas
Parcel size selection is fixed at order creation (A, B, or C) and determines which locker compartment is reserved; selecting a size that does not match the physical parcel will cause a delivery failure at the locker.
The recipient's mobile phone number is essential — InPost sends an access code via SMS when the parcel arrives; an incorrect number means the customer cannot retrieve the package.
Locker capacity at a specific machine is not guaranteed; build a fallback in your checkout flow to offer alternative lockers or standard home delivery if the customer's preferred locker is full.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp