Webhooks allow you to collect information about events as they happen in near real-time. Provide a URL and what event you want to receive data about, and we’ll send it to you as the events take place.

For general reading on Webhooks, read the PBWiki Webhooks page.

To test our Webhooks before setting up scripts, the RequestBin tool is an excellent utility that helps you see data come across as various events happen in our system.

Configuring WebHooks

Webhooks are configured from your Sello account. Here are the basic steps:

  1. Log in to your Sello account
  2. Navigate to Settings
  3. Click Developers -> WebHooks

Configuration is simple: Enter a valid url for us to contact, then select the event and you want to have sent to you.

Securing Webhooks

We currently support either HTTP or HTTPS urls, so you can have security by using an SSL-enabled url. But keep in mind that your endpoint is going to be wide-open on the internet, and you might not want others to be able to submit random data to your systems. At this time, aside from trying to keep the URL private, our best suggestion is to simply include a secret key in the URL your provide and check that parameter in your scripts.

Supported Events

Our Webhooks implementation currently support the following events:

  • New order (also triggered if an order is updated)
  • Paid order
  • Updated order
  • Product update
  • Product quantity update

Event Data

When an event occurs that you have turned on, we’ll send a HTTP POST request to the URL you’ve specified. If that URL is unavailable, returns a 500-ish status code or takes too long to respond (more than 15 seconds), we’ll cancel the request and try again later. Retries happen over the course of one hour and 15 minutes. This may be tweaked as we receive feedback from users.

The webhook that Sello send will only contain the ID of the order or the ID of the product that is triggering the webhook. You will then need to fetch the actual data from Sello API v5 with that product ID or order ID.