> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novacal.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Webhooks

> List the webhooks registered on your Novacal account, including their target URL, subscribed events, signing secret, and active status.

## What this endpoint returns

This endpoint returns every webhook you have registered, newest first. Each entry includes its target URL, the events it is subscribed to, its signing secret, and whether it is currently active.

## Common use cases

* Audit which endpoints are receiving Novacal deliveries
* Retrieve a signing secret you need to verify incoming requests
* Confirm which webhooks are paused before debugging a missing delivery


## OpenAPI

````yaml GET /v1/webhooks
openapi: 3.1.0
info:
  title: Events API
  description: Public API for managing event types
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.novacal.io
security:
  - bearerAuth: []
paths:
  /v1/webhooks:
    get:
      description: Returns the webhooks registered by the authenticated user.
      responses:
        '200':
          description: Webhooks response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhooksResponse'
components:
  schemas:
    WebhooksResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          description: Indicates whether the request was successful
          type: boolean
          example: true
        data:
          type: array
          items:
            $ref: '#/components/schemas/Webhook'
    Webhook:
      type: object
      properties:
        id:
          description: The unique identifier of the webhook
          type: integer
          example: 1
        url:
          description: The URL Novacal sends deliveries to
          type: string
          example: https://example.com/hooks/novacal
        events:
          description: The events this webhook is subscribed to
          type: array
          items:
            type: string
            enum:
              - event.created
              - event.rescheduled
              - event.canceled
          example:
            - event.created
            - event.canceled
        secret:
          description: >-
            The signing secret used to verify deliveries. Compare it against the
            `X-Novacal-Signature` header.
          type: string
          example: novacal_wh_YOUR_SIGNING_SECRET
        is_active:
          description: Whether Novacal is currently sending deliveries to this webhook
          type: boolean
          example: true
        created_at:
          description: The date and time the webhook was created
          type: string
          format: date-time
        updated_at:
          description: The date and time the webhook was last updated
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````