With your permission, we use Google Analytics to understand visits, demo views, and signups. Optional analytics stays off until you accept. Essential cookies keep the site working.

Privacy policy

Developers

Webhooks

Get signed change notices on your own HTTPS receiver when bookings, orders or invoices change.

On this page

Outbound webhooks send a small, signed JSON notice to your HTTPS receiver when something changes in CaterCamp. They are available on the Business plan and during the free trial, and are managed in Settings → Webhooks by owners and administrators with settings access.

A notice is a change hint. It names what changed (for example a booking or invoice ID), and your system then reads the current record with a Business API key.

Setting up a receiver

  1. In Settings → Webhooks, choose Add endpoint. Enter your HTTPS URL, the notice types you want and the data boundary (whole workspace or selected locations).
  2. Copy the signing secret. It is shown once and starts with ccwhsec_.
  3. Verify the receiver. CaterCamp sends a challenge; your receiver must answer with a 2xx response that includes a CaterCamp-Webhook-Challenge header equal to data.challenge from the request body, within ten seconds.
  4. Approve sharing. Nothing is sent until the receiver is verified and you confirm what it may receive.

You can pause, resume or permanently revoke an endpoint at any time. Pausing and revoking stop new sends; an attempt already in flight cannot be recalled.

Request format

Each delivery is an HTTPS POST with a JSON body (at most 64 KiB) and these headers:

HeaderMeaning
CaterCamp-Signaturet=<Unix seconds>,v1=<hex HMAC-SHA256>
CaterCamp-Event-IdStable ID of the change. Use it to deduplicate.
CaterCamp-Delivery-IdStable for one notice to one endpoint.
CaterCamp-Attempt-IdNew for each attempt.
User-AgentCaterCamp-Webhooks/1

The body contains the event ID, workspace ID, occurrence time, API version, notice type and the resource IDs. It never contains client contact details, addresses, prices, notes, mail or financial ledgers.

{
  "id": "<event ID>",
  "apiVersion": "2026-10-24",
  "workspaceId": "<workspace ID>",
  "occurredAt": "2026-12-01T15:04:05.000Z",
  "type": "invoice.issued",
  "data": { "invoiceId": "<invoice ID>" }
}

Verifying signatures

Verify every request before you trust it:

  1. Take the part of your secret after ccwhsec_ and base64url-decode it into a 32-byte key.
  2. Compute HMAC-SHA256 with that key over the timestamp, a period (.) and the exact raw request body bytes, before parsing JSON.
  3. Compare your result with v1 using a constant-time comparison.
  4. Reject requests whose timestamp is more than five minutes from your clock.
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(rawBody, secret, header) {
  const match = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(header ?? "");
  if (!match) return false;
  const [, t, v1] = match;
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const key = Buffer.from(secret.slice("ccwhsec_".length), "base64url");
  const expected = createHmac("sha256", key)
    .update(`${t}.`)
    .update(rawBody)
    .digest();
  return timingSafeEqual(expected, Buffer.from(v1, "hex"));
}

Retries and duplicates

  • Only a complete 2xx response acknowledges a notice. Failed attempts are retried up to eight times with backoff over roughly 45 hours; a notice expires after 72 hours.
  • Redirects, invalid TLS, private network addresses and most 4xx responses stop retries and show the endpoint as needing review.
  • Notices can arrive more than once or out of order. Deduplicate on the event ID inside the signed body, and keep those records for at least 31 days.
  • You can redeliver a notice from the endpoint's delivery history up to three times within 30 days.
  • To catch up after downtime, read retained notices with GET /api/v1/webhook-endpoints/:id/notices using a key with webhooks:read and the matching data permission (up to 30 days per request).

Notice types

TypeWhen it is sent
event.created / event.deletedA booking was created or deleted.
event.details.changedBooking details changed (lists changed field names).
event.status.changedThe booking's status changed.
event.meals.changedThe meal schedule changed (lists added, updated or removed meal IDs).
event.order.updatedThe working order changed.
event.business.changedThe booking's location or brand changed.
event.scope.leftA booking left this receiver's location boundary.
event.guarantee.changedThe guest guarantee or its confirmation changed.
event.instructions.published / .withdrawn / .acknowledgedCustomer instructions were shared, recalled or acknowledged.
event.proposal.accepted / event.proposal.declinedA customer accepted or declined a proposal.
event.change_request.changed / .follow_up_sharedA customer portal change request changed, or the caterer shared a follow-up.
event.online_request.changedAn online catering request was submitted, revised or decided.
event.delivery.changed / event.pickup.changedA delivery or equipment pickup changed.
event.corporate_request.linked, corporate_request.*Corporate catering requests were submitted, routed, scheduled or decided.
branch.catalogue.changedA location published a catalogue policy.
invoice.issued, invoice.lifecycle.changed, invoice.schedule.changed, invoice.credit.changed, invoice.payment.changed, invoice.refund.changed, invoice.dispute.changedAn invoice was issued or its status, schedule, credits, payments, refunds or disputes changed.

Try it with your next real event

Fourteen days with every Business feature. Add one booking, one menu and your team, then choose the plan that fits.

Start your free trial