Introduction

Getting started with Webhooks for Shine Connect

To avoid long polling and daily syncs, Shine Connect now offers a webhook functionnality.

👍

Enable webhooks

To enable webhooks for your account, send us an email at [email protected] with the following information:

  • the events you want to listen too
  • the urls to which the webhooks will be sent both for your sandbox and production environments

Supported events

Shine Connect can deliver webhooks for the following events:

  • invoices.create
  • invoices.update
  • receipts.create
  • receipts.update
    [block:callout]
    {
    "type": "info",
    "body": "If you would like us to support additional events, please contact us at [email protected] "
    }
    [/block]

🚧

You won’t be able to listen for events which aren’t included in your authorized scopes.

Steps to receive webhooks

You can start receiving webhooks using the following steps:

  1. Identify the events you want to subscribe to.
  2. Create a webhook endpoint as a publicly accessible HTTPS URL.
  3. Send an email to [email protected] with the list of events and the handler url.
  4. Handle requests from Shine by parsing each webhook and returning 2xx response status codes.