Receive webhooks when something happens

Webhooks notify your own systems the moment something happens on the Printeers platform. Instead of polling the API to see whether anything changed, you give us a URL and we call it when an event occurs, for example when a shipment is created for one of your orders. Your system then fetches the details from the API.

Webhooks are currently in beta: they are fully functional and you can build on them today, but while we process feedback from the first users we may still refine details.

Webhooks are meant for developers: you need an endpoint on your side that can receive HTTPS requests, and an API integration to fetch the details. Everything technical, the delivery contract, payload format, signature verification, retry behavior, and code examples, lives in the developer documentation.

Add a webhook endpoint

Open Webhooks in the Dashboard and create an endpoint: enter the HTTPS URL of your receiving system and pick the events the endpoint should receive. An endpoint belongs to your organization and receives the chosen events for all your stores; you can create more than one webhook endpoint, each with its own URL and event selection.

After creating the endpoint, copy its signing secret and hand it to your developers; it is shown only once.

When deliveries fail

Failed deliveries are retried automatically, and the endpoint page shows a delivery log; open a delivery to see every attempt, including the HTTP status and the response your endpoint returned. The log keeps deliveries for 90 days. If an endpoint keeps failing for days on end we disable it, and events from the disabled period are not delivered afterwards. Once the receiving system is fixed, re-enable the endpoint on the Webhooks page and have your systems catch up through the API.