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
    {
      "type": "info",
      "body": "If you would like us to support additional events, please contact us at [[email protected]](mailto:[email protected]) "
    }
    

๐Ÿšง

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.