Skip to content
English
Visit your Brand Dashboard
  • There are no suggestions because the search field is empty.

Getting Started with the Order Webhook

Automatically receive order data and shipping documents as soon as they're ready

What is this?

The Order Ready to Ship webhook automatically sends order details and shipping documents to your own system as soon as an order is accepted and its shipping label, packing slip and (where applicable) waybill are ready.

Your fulfilment or warehouse management system receives everything it needs to pick, pack and ship the order, with no need to log into the Wolf & Badger platform or check for updates manually.

Who needs to action this?

This is a technical setup. It needs to be completed by whoever manages your fulfilment, warehouse or IT systems, someone comfortable setting up a URL that can receive data automatically. If that's not you, forward this article to them.

What you'll need before you start

  • An HTTPS endpoint: a web address your system controls, that can receive and process incoming data automatically. If your fulfilment or warehouse software already supports "webhooks" or "inbound integrations", this is what you'll point us to.
  • Someone to build the receiving logic: your system needs to accept the incoming order data, verify it's genuinely from Wolf & Badger (see below), and save or process the attached documents.

How to set it up

  1. Build your endpoint. Set up a web address that can accept incoming data in the format described in this article (see Request Format below).
  2. Make sure it returns a 200 OK response. This confirms to us that you've received the order successfully. Without it, we'll keep resending the same order every 15 minutes for up to 3 days.
  3. Send us your endpoint URL. Share it with your Wolf & Badger contact, and we'll connect it on our end.
  4. We'll send you a secret token by email. Use this to verify that incoming requests genuinely come from us and haven't been tampered with (see Verifying the Signature below for the code you'll need).
  5. We'll send a test event. Once connected, confirm you're receiving and correctly processing orders before it goes live.

What you'll receive

Every time an order is accepted and its shipping documents are ready, your endpoint will receive:

  • The order number
  • The shipping label, packing slip and waybill as ready-to-use files
  • What's in the shipment and any gift message

No further action is needed on your side once it's set up.

Registration

Setup is currently manual: you send us your endpoint URL and we configure it together. Self-service registration through the Brand Dashboard is planned for a future release. Please contact us here to get this set up. 

Technical docs here