These docs are for v3.0. Click to read the latest docs for v3.1.

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.