Agent skill

Spacebring Webhooks Skill

Receive and verify Spacebring webhooks (coworking and flexible-workspace management, delivered via Svix). Use when setting up Spacebring webhook handlers, debugging svix-signature verification, or handling events like booking.created, membership.created, shop.order.paid, and visitors.visit.checked_in.

Install this skill

npx skills add hookdeck/webhook-skills --skill spacebring-webhooks


Spacebring delivers webhooks through Svix, which implements Standard Webhooks. Every delivery is an HTTP POST with a JSON body and three signature headers: svix-id, svix-timestamp, and svix-signature. Most bodies have a top-level type string beside one resource object (booking, company, event, ticket, membership, order, application), but Spacebring's docs never show the value of type. subscription.* bodies are the bare subscription object, and visitors.* bodies carry visit only. Svix's headers carry no event type.

When to Use This Skill

  • How do I receive Spacebring webhooks?
  • How do I verify Spacebring webhook signatures (svix-signature)?
  • How do I handle booking.created, membership.created, or shop.order.paid events?
  • How do I react to visitors.visit.checked_in or subscription.purchased?
  • Why is my Spacebring webhook signature verification failing, or rejecting Hookdeck retries?

Verification (core)

Signed content is {svix-id}.{svix-timestamp}.{raw body}. Svix signs it with HMAC-SHA256 using the base64-decoded secret (the part after whsec_), base64-encodes the result, and sends one or more space-separated v1,<signature> entries. Use the official svix library, which compares in constant time. Read the svix-* headers, and when svix-id is absent fall back to the webhook-* headers (webhook-id, webhook-timestamp, webhook-signature).

import { Webhook } from 'svix'; // svix 2.x is ESM-only

const prefix = req.headers['svix-id'] ? 'svix' : 'webhook';
const id = req.headers[`${prefix}-id`];
const timestamp = req.headers[`${prefix}-timestamp`];
const signature = req.headers[`${prefix}-signature`];
// rawBody: the raw Buffer/string, never re-serialized JSON
new Webhook(process.env.SPACEBRING_WEBHOOK_SECRET).verify(rawBody, {
  'svix-id': id, 'svix-timestamp': timestamp, 'svix-signature': signature,
  'webhook-id': id, 'webhook-timestamp': timestamp, 'webhook-signature': signature,
}); // throws on a bad signature or a timestamp outside the window
const event = JSON.parse(rawBody.toString('utf8')); // parse only after verify passes
from svix.webhooks import Webhook, WebhookVerificationError

wh = Webhook(os.environ["SPACEBRING_WEBHOOK_SECRET"])  # "whsec_..."
wh.verify(raw_body, {"svix-id": id, "svix-timestamp": ts, "svix-signature": sig,
                     "webhook-id": id, "webhook-timestamp": ts, "webhook-signature": sig})

For complete handlers with tests, see examples/express/, examples/nextjs/, examples/fastapi/.

The signing secret is on the webhooks management page (Network settings > Developers > Webhooks) and starts with whsec_. Keep the full whsec_... value in SPACEBRING_WEBHOOK_SECRET. Handlers fail closed: with the variable unset they return 500 instead of accepting anything.

Hookdeck retries and replays hit the 5-minute window

The svix and standardwebhooks libraries always enforce a fixed 5-minute timestamp window, and it can't be configured. Hookdeck retries and replays resend the original svix-timestamp, so the library rejects any retry or replay that happens more than 5 minutes after the original delivery. If you verify behind Hookdeck (or replay old events), use the manual verifier in references/verification.md, where the window can be dropped or widened. Deduplicate on svix-id instead of relying on the timestamp.

Common Event Types

32 events are documented (the list may not be exhaustive). The examples route all of them on the top-level type field and acknowledge anything else with 200:

EventTriggered When
booking.createdA booking is made (also booking.updated, booking.deleted, booking.paid)
company.createdA company is created (also company.deleted)
membership.createdA membership is created (also membership.invited)
event.createdAn event is created (also event.updated, event.deleted, event.canceled)
event.ticket.createdAn event ticket is created (also event.ticket.paid)
shop.order.createdA shop order is placed (also shop.order.paid)
subscription.purchasedA subscription is purchased (also subscription.created, .updated, .deleted)
invoice.issuedAn invoice is issued
support.ticket.createdA support ticket is created
benefit.application.createdA benefit application is created
visitors.visit.checked_inA visitor checks in (also visitors.visit.checked_out, visitors.request.approved)
location.*, resource.*Locations and resources are created, updated or deleted

See references/overview.md for the full catalog and payload notes.

Environment Variables

# Signing secret from Network settings > Developers > Webhooks (Svix format, starts with whsec_)
SPACEBRING_WEBHOOK_SECRET=whsec_xxxxx

Local Development

# Start tunnel (no account needed)
npx hookdeck-cli listen 3000 spacebring --path /webhooks/spacebring

As the network owner, register the tunnel URL under Network settings > Developers > Webhooks (the API & webhooks add-on is required), then trigger an event (for example, create a booking).

Reference Materials


Repository

hookdeck/webhook-skills

v0.1.0 · MIT · Updated Nov 17, 2026

View on GitHub →