Webhooks

Gets a webhook subscription by id.

Requires Admin. Never returns secret values.

get/api/v1/orgs/{org}/webhooks/{id}

Request

  • Base URL: https://api.featureflip.io
  • URL: https://api.featureflip.io/api/v1/orgs/{org}/webhooks/{id}
  • Auth: API key in header Authorization

Path parameters

orgstring required
idstring required

Headers

If-Matchstring

Optional. An ETag of this resource. The response is 200 only if it is still the current one; otherwise 412 precondition_failed. * or no header always reads.

Response

OK

idstring uuid required
namestring nullable required
urlstring nullable required
provider'GenericHttp' nullable required

Allowed values: GenericHttp.

isEnabledboolean required
eventTypesstring[] nullable required
projectIdsstring[] nullable required
environmentIdsstring[] nullable required
consecutiveFailureCountinteger required
autoDisabledAtstring date-time nullable
createdAtstring date-time required
updatedAtstring date-time required
overPlanLimitboolean required
_actionsobject

Capability hints: which operations the authenticated caller may perform on this resource, each with allowed + optional reason. Computed from the caller's role and the resource's state. Injected at runtime; safe to ignore. Present only on top-level resource responses — nested occurrences (e.g. a rule inside a targeting-config response) do not carry it.

Example response

{
  "id": "0197b6a4-6f7a-7b8c-9d0e-1f2a3b4c5d6e",
  "name": "Checkout flag changes to Slack relay",
  "url": "https://hooks.acme.example/featureflip",
  "provider": "GenericHttp",
  "isEnabled": true,
  "eventTypes": [
    "flag.toggled",
    "flag.updated"
  ],
  "projectIds": [
    "0197b69f-1a2b-7c3d-8e4f-5a6b7c8d9e0f"
  ],
  "environmentIds": [
    "0197b69f-2b3c-7d4e-9f5a-6b7c8d9e0f1a"
  ],
  "consecutiveFailureCount": 0,
  "overPlanLimit": false,
  "createdAt": "2026-06-01T12:00:00Z",
  "updatedAt": "2026-06-15T08:30:00Z",
  "secrets": [
    {
      "id": "0197b6a4-7a8b-7c9d-8e0f-2a3b4c5d6e7f",
      "createdAt": "2026-06-01T12:00:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.