BespokeBox
← Docs

Webhooks

Receive a JSON payload in Zapier, Make, Airtable, or your own backend every time you generate a listing. Perfect for auto-publishing drafts, syncing to a spreadsheet, or piping into your own Etsy uploader.

Setting up

  1. Head to Settings → Integrations and paste your webhook URL.
  2. Click Save, then Send test to verify delivery.
  3. From now on, every successful /api/generate call will POST the payload below to your URL.

Event payload

All payloads are JSON with Content-Type: application/json and the header User-Agent: BespokeBox-Webhook/1.0.

{
  "event": "listing.generated",
  "timestamp": "2026-04-09T14:22:03.117Z",
  "listingId": "clxabcd1234",
  "product_keywords": "linen Christmas stockings",
  "listing": {
    "title": "Linen Christmas Stockings — Handmade Personalised Family Set",
    "description": "...",
    "tags": ["linen stocking", "xmas decor", "..."],
    "variations": ["Size", "Colour"],
    "price_range": "£22-£38"
  }
}

Zapier example

  1. Create a new Zap and pick Webhooks by Zapier as the trigger.
  2. Choose Catch Hook and copy the provided URL.
  3. Paste it into BespokeBox's Settings → Integrations and save.
  4. Click Send test — Zapier will pick up the sample payload.
  5. Add any downstream step — Google Sheets, Airtable, Notion, Slack, Etsy (via OAuth), etc.

Make (formerly Integromat) example

  1. Create a new scenario and add a Webhooks → Custom webhook module.
  2. Copy the generated URL and paste it into BespokeBox.
  3. Hit Send test; Make will auto-detect the schema.
  4. Chain any Make module — Airtable, Google Drive, HTTP, Data store, etc.

Retries & timeouts

BespokeBox gives your endpoint 5 seconds to respond. We do not retry on failure — the last delivery status is shown in Settings → Integrations so you can spot problems. Make sure your receiver returns a 2xx response quickly; do any heavy work asynchronously on your side.

Security

Webhooks are sent from BespokeBox's servers over HTTPS. If your endpoint needs to verify the origin, add a secret path segment or query parameter to your URL (e.g. /hooks/bb?token=xxx) and check it on the receiver side.

Availability: Maker and Studio plans. See pricing.