# List All Webhooks

Retrieve all webhooks in your workspace. By default, results are paginated with 50 rows per page. Use this resource to manage and administer your webhooks. With this resource, you can register callback URLs to receive real-time event notifications from our platform. Once registered, you'll automatically receive notifications whenever new events occur—such as data updates, member actions, or system alerts.

Endpoint: GET /webhooks
Version: 2.0.0
Security: oauth2, apiKey

## Query parameters:

  - `workspace_id` (integer, required)
    ID of the workspace
    Example: 1

  - `page` (integer)
    Page number for pagination
    Example: 1

## Response 200 fields (application/json):

  - `max_rows` (integer)
    Total number of webhooks
    Example: 50

  - `current_page` (integer)
    Current page number
    Example: 1

  - `total_pages` (integer)
    Total number of pages
    Example: 3

  - `data` (array)

  - `data.id` (string, required)
    Encoded ID of the webhook
    Example: "abc123def456"

  - `data.url` (string, required)
    The callback URL where webhook events will be sent
    Example: "https://example.com/webhook/endpoint"

  - `data.events` (array, required)
    Array of event types that this webhook is subscribed to
    Enum: "tracker.started", "tracker.stopped"

  - `data.token` (string, required)
    Secret token for verifying webhook authenticity
    Example: "whsec_1234567890abcdef"

## Response 401 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Error message describing what went wrong
    Example: "An error occurred"

  - `error` (string,null)
    Optional additional error details
    Example: "Internal Server Error"

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)

## Response 500 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Error message describing what went wrong
    Example: "An error occurred"

  - `error` (string,null)
    Optional additional error details
    Example: "Internal Server Error"

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: "2.0.0"

  - `meta.timestamp` (string)