> ## Documentation Index
> Fetch the complete documentation index at: https://cobalt-55-abhishek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Webhooks

> List all webhooks registered for your organization.

Retrieve all webhook subscriptions registered for your organization and environment. Use this to audit configurations or find a webhook ID for management.

## Authentication

<ParamField header="x-api-key" type="string" required>
  Your Refold API key. Find it in **Settings → Credentials**.
</ParamField>

## Response

<Tabs>
  <Tab title="200 OK">
    Returns an array of webhook objects.
    <ResponseField name="_id" type="string">Webhook ID.</ResponseField>
    <ResponseField name="webhook_url" type="string">Delivery URL.</ResponseField>
    <ResponseField name="webhook_events" type="array">Subscribed events.</ResponseField>
    <ResponseField name="is_enabled" type="boolean">Whether the webhook is active.</ResponseField>
    <ResponseField name="webhook_type" type="string">Payload format: `default`, `slack`, or `custom`.</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 timestamp.</ResponseField>
  </Tab>

  <Tab title="401 Unauthorized">
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="http_error_type" type="string">Error category.</ResponseField>
    <ResponseField name="error" type="string">Internal error code.</ResponseField>
    <ResponseField name="message" type="string">Human-readable error description.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "_id": "69c4c8ece6c48f40c1d3ff42",
      "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
      "environment": "test",
      "is_enabled": false,
      "webhook_events": ["Connection Created", "Connection Deleted", "Workflow Completed", "Workflow Errored"],
      "webhook_url": "https://your-app.com/webhooks",
      "webhook_type": "default",
      "method": "POST",
      "createdAt": "2026-03-12T08:14:02.110Z"
    }
  ]
  ```

  ```json 401 theme={null}
  {
    "status_code": 401,
    "http_error_type": "UNAUTHORIZED",
    "error": "SERVER_ERROR",
    "message": "Invalid Credentials"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/webhook" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>