FurniOpsDocs
API referenceWebhooks

Delete a webhook endpoint

Stops every delivery to the endpoint and forgets its secrets.

  • Scopeswebhooks:write
  • Rate classwrite
DELETE/v1/webhook-endpoints/{id}

Stops every delivery to the endpoint and forgets its secrets.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Path Parameters

id*string

Webhook endpoint ID

Match^whe_[0-9A-Za-z]{22}$

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
FurniOps-Dry-Run?string

Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)

Value in

  • "true"
  • "explain"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://example.com/v1/webhook-endpoints/string"
{  "object": "webhook_endpoint",  "id": "string",  "deleted": true}

Create a webhook endpoint POST

Starts pushing the chosen public events to the URL, signed with Standard Webhooks `v1` (`webhook-id`, `webhook-timestamp`, `webhook-signature`). The answer carries the signing secret once. Live-mode endpoints need HTTPS; URLs that resolve to private addresses are refused (422). An organisation has at most 20 endpoints.

Get a delivery GET

One delivery with the payload as sent and every attempt: when, the status, how long it took, and the start of the receiver's answer.