get_webhook_endpoint

One of the team's outbound webhook endpoints by UUID, with its health counters. The signing secret is never returned.

Purpose

Read one endpoint back: its target, the events it receives, whether it is active, and the health counters the dashboard shows — total failures, the current consecutive-failure streak and the last success and failure instants. The row is the one list_webhook_endpoints returns.

Never the secret

The signing secret exists in the create_webhook_endpoint and rotate_webhook_endpoint_secret responses only. If a consumer has lost it, rotate.

Required ability

webhook-endpoint:view

Input schema

{
  "type": "object",
  "required": ["endpoint_id"],
  "properties": {
    "endpoint_id": {
      "type": "string",
      "description": "UUID of the webhook endpoint to fetch."
    }
  }
}

Output shape

{
  "data": {
    "id": "c62a08f4-1b7d-4e35-9860-a37f5d21e0b9",
    "name": "CRM sync",
    "url": "https://hooks.example.com/subscriby",
    "project_id": null,
    "events": ["subscription.created", "subscription.cancelled"],
    "is_active": true,
    "disabled_at": null,
    "allowed_ips": [],
    "failure_count": 2,
    "consecutive_failures": 0,
    "last_success_at": "2026-09-05T18:00:00+00:00",
    "last_failure_at": "2026-08-30T07:12:00+00:00",
    "created_at": "2026-05-18T10:05:00+00:00"
  }
}

consecutive_failures is the streak that disables an endpoint when it runs too long; failure_count is the lifetime total. disabled_at is set when the endpoint is paused, by a person or by the streak.

Example prompts

"Is webhook endpoint c62a08f4-1b7d-4e35-9860-a37f5d21e0b9 healthy? When did it last succeed?"

"Which events does the CRM sync endpoint receive?"

"Is that endpoint paused, and since when?"

Failure modes

RESOURCE_NOT_FOUND — unknown endpoint_id, or an endpoint of another team.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks webhook-endpoint:view.

list_webhook_endpoints — every endpoint of the team.
list_webhook_deliveries — why the counters look the way they do.
Webhook endpoints API — the REST equivalent.