> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tillbiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Send TillBiz events to your own systems in real time.

**Webhooks** let TillBiz notify your own systems the moment something happens — a
sale is made, a payment is received, an invoice is paid. They're how you connect
TillBiz to custom tools and workflows.

<Note>
  Webhooks are part of the **Custom integrations** feature, typically on higher
  tiers. If you don't see the Webhooks tab in Settings, your plan may not include
  it — see [Subscription & licensing](/guides/billing-addons/subscription-and-licensing).
  This is a more technical feature; your developer may help set it up.
</Note>

## How they work

You register an **endpoint** (a URL) in TillBiz and choose which **events** it
should receive. When one of those events happens, TillBiz sends a signed message
to your URL with the details.

## Add an endpoint

<Steps>
  <Step title="Open the Webhooks settings">
    Go to **Settings → Webhooks** and click **Add endpoint**.
  </Step>

  <Step title="Enter your URL">
    Provide the URL where TillBiz should send events.
  </Step>

  <Step title="Select events">
    Choose which events this endpoint should receive — for example order,
    payment, and invoice events.
  </Step>

  <Step title="Save">
    The endpoint starts receiving the events you selected.
  </Step>
</Steps>

## Signing secret

Each endpoint has a **signing secret** that TillBiz uses to sign every delivery,
so your system can verify a request genuinely came from TillBiz. From the
endpoint you can:

* **Reveal** and **copy** the secret to configure your receiver.
* **Regenerate** the secret if it's ever exposed (update your system afterward).

<Warning>
  Treat the signing secret like a password. Anyone with it could send requests that
  look like they came from TillBiz. Regenerate it immediately if it leaks.
</Warning>

## Test & monitor

* **Test** an endpoint to send a sample delivery and confirm your URL responds —
  TillBiz reports the HTTP status it got back.
* Open **Logs** to see recent deliveries, their status, and any failures.

TillBiz retries deliveries when your endpoint is temporarily unavailable, so a
brief outage won't lose events.

<Tip>
  Start by adding an endpoint, sending a **test**, and checking the **Logs** —
  that confirms the connection end to end before you rely on live events.
</Tip>