---
title: Webhooks & integrations
id: webhooks
description: Push GigBook events (inquiries, contracts, payments, planning) to Make.com, n8n, or Zapier with token-authenticated webhooks — keep Monday and your other tools in sync.
category: Developers
order: 42
tags: [webhooks, integrations, make, n8n, zapier, monday]
related: [using-the-api]
updated: 2026-07-01
---

GigBook can **POST a JSON event to your own endpoints** whenever something happens —
a new inquiry, a signed contract, a payment, a completed planning form, an updated event.
Point those at **Make.com**, **n8n**, or **Zapier** and GigBook becomes the source of truth
while your other tools (like Monday.com) stay in sync automatically — no double entry.

## Set one up

In **Settings → Webhooks & integrations**, add your endpoint URL (e.g. a Make.com custom
webhook). GigBook generates a secret **token** for that endpoint — it's sent in the
`X-GigBook-Token` header on every request, so your receiver can require it and
reject anything that doesn't match. Use **Send test** to fire a `ping` and confirm it works;
recent deliveries (with HTTP status) show at the bottom of the page.

## Events

Every endpoint receives all event types — branch on the `type` field in your automation.

| Event | Fires when… |
|---|---|
| `inquiry.created` | someone submits your booking form |
| `contract.signed` | a contract is e-signed |
| `payment.paid` | a payment is marked paid |
| `planning.completed` | the planning form is finished |
| `event.updated` | booking details are saved |

## Payload

Each delivery is a JSON body:

```json
{
  "id": "…",
  "type": "payment.paid",
  "created_at": "2026-07-01T18:20:00.000Z",
  "org_id": "…",
  "data": { "event_id": "…", "payment_id": "…", "label": "Deposit", "amount_cents": 50000 }
}
```

With these headers:

- `X-GigBook-Token` — your endpoint's secret token (see below)
- `X-GigBook-Event` — the event type
- `X-GigBook-Delivery` — a unique id for this delivery

## Confirm it's really from GigBook

Every request includes your endpoint's secret token in the `X-GigBook-Token` header:

```
X-GigBook-Token: <your token>
```

On your receiver, **check that this header matches your token and ignore anything that
doesn't** — that's the whole check, no signatures or crypto. Keep the token secret, use an
HTTPS endpoint, and rotate the token any time from the settings page.

## Make / n8n / Zapier

- **Make.com** — add a *Custom webhook* trigger, paste its URL into GigBook, and route on the
  `type` field (e.g. `inquiry.created` → create a Monday item). To verify the token, add a
  step that only continues when the incoming `X-GigBook-Token` header equals your token.
- **n8n** — a *Webhook* node; compare the `X-GigBook-Token` header to your token.
- **Zapier** — *Catch Hook* trigger; filter on the `X-GigBook-Token` header + `type`.

## Checklist

- [ ] Add your endpoint in Settings → Webhooks & integrations
- [ ] Send a test and confirm it arrives
- [ ] Require the `X-GigBook-Token` header on your side
- [ ] Branch on `type` and map fields into your tool (Monday, etc.)
