list_webhook_endpoints

List outbound webhook endpoints registered for the caller's team. Optional project_id filter, optional active_only filter. Secrets are never returned.

Purpose

List outbound webhook endpoints registered for the caller's team. Optionally scoped to a single project, or filtered to active endpoints only. Useful for sanity-checking integrations after a suspected outage.

Endpoint secrets are never returned by this tool. They are surfaced only at the moment of creation or rotation via the dashboard or the rotate-secret REST endpoint.

Required ability

webhook-endpoint:manage

Input schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "description": "Optional project UUID. Omit to list team-wide endpoints and all project-scoped endpoints within the team."
    },
    "active_only": {
      "type": "boolean",
      "description": "When true, hides endpoints with is_active=false or disabled_at set."
    }
  }
}

Output shape

{
  "data": [
    {
      "id": "whe_01HX...",
      "name": "Zapier trigger",
      "url": "https://hooks.zapier.com/...",
      "project_id": "prj_01HX...",
      "events": ["subscription.created", "payment.succeeded"],
      "is_active": true,
      "disabled_at": null,
      "allowed_ips": null,
      "failure_count": 0,
      "consecutive_failures": 0,
      "last_success_at": "2026-05-18T10:05:00Z",
      "last_failure_at": null,
      "created_at": "2026-04-01T10:05:00Z"
    }
  ],
  "meta": { "total": 3 }
}

Example prompts

"List our active webhook endpoints."

"Which webhook endpoints have had failures recently?"

Failure modes

TOKEN_MISSING_ABILITY — token lacks webhook-endpoint:manage.