Integrations

InPost ShipX

InPost shipping API

InPost ShipX is the API for creating parcel locker and courier shipments, downloading labels and tracking parcel statuses straight from your store.

Official site

What is InPost ShipX?

InPost ShipX is InPost's API for handling shipments from your own system: creating Paczkomat parcel locker and courier shipments, downloading labels and tracking statuses. Choosing a parcel locker at checkout is handled by a separate component, the Geowidget, which returns the ID of the selected point. For testing, InPost provides a ShipX sandbox that works without a contract.

How we use it at Koda Plus

We build InPost integrations directly on the ShipX API rather than on bloated plugins: the Geowidget at checkout, shipment creation, labels in PDF or in ZPL for thermal printers, and status tracking. In Medusa.js stores we keep the selected locker ID in the cart's shipping method metadata, and in B2B projects we tie label retrieval to an order status change. We describe the full flow in a Polish-language blog post and deliver it as part of our system integration work.

When it makes sense

  • Your customers expect parcel lockers at checkout
  • Your warehouse prints many labels and clicking through the InPost panel wastes time
  • Your store should update orders and emails automatically from parcel status
  • Your platform is custom-built, for example on Medusa.js, with no ready-made module

Frequently asked questions
InPost ShipX

  • Do I need a contract to integrate with InPost?

    For live shipments, yes – the ShipX API token is generated in InPost's Manager Paczek panel, which you get access to under a contract. You can still build and test the whole integration beforehand in the ShipX sandbox, which has its own token and works without a contract.

  • How do I track an InPost shipment status via the API?

    ShipX provides a dictionary of statuses and tracking by shipment number. Your store can poll the API for active shipments or receive webhooks that InPost sends when a status changes. It is worth mapping InPost statuses onto a few simpler order statuses that customers see.

  • How do I add parcel locker selection to my checkout?

    The simplest route is the Geowidget, InPost's ready-made map component embedded with a single tag. Once a customer picks a point it returns the point ID, such as KRA012, which is saved with the order and passed to ShipX. The Geowidget uses its own token, separate from the ShipX token.

Free 15-minute call

Tell us about your project,
we'll tailor the rest to you

A 15-minute call is enough for us to know whether we are a fit for your project.
We start from what you need, not from an off-the-shelf solution.

Contact us

Remigiusz in a navy shirt and glasses
I use iMessage I use WhatsApp
Adrian in a grey turtleneck and glasses
I use iMessage I use WhatsApp