SapanBaseDevelopers

Create a webhook

Returns the signing secret ONCE. Subscribing to an event requires the read scope protecting it.

POSThttps://api.helpbento.com/v1/webhooks

Authentication

AuthorizationstringheaderBearer <token>required

An API key, e.g. hb_live_… (live) or hb_test_… (test).

Header parameters

1 param
  • Idempotency-Keystringlength: 0…255

    Optional idempotency key (1–255 chars). Repeating a mutating request with the same key within 24h replays the original response instead of re-executing it; a concurrent in-flight request with the same key returns 409. Use a unique key (e.g. a UUID) per logical operation so network retries are safe.

Request body

application/jsonrequired
  • urlstringurirequired

    HTTPS endpoint (no internal/private hosts).

  • eventsarray of stringrequired

Responses

  • idstring
  • urlstringuri
  • eventsarray of string
  • statusstringactive | disabled
  • createdAtstringdate-time
  • signingSecretstring

    Shown once. Verify the X-HelpBento-Signature header with it.

Errors