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

# List Webhooks

> List the webhook endpoints your token registered

List the webhook endpoints your token registered, with their signing `secret`. An endpoint
another token registered on the same workspace is not listed: each integration only sees its
own.


## OpenAPI

````yaml GET /webhooks
openapi: 3.0.0
info:
  title: Penbox API
  version: '1.0'
  description: >-
    The Penbox API provides programmatic access to Penbox's form management,
    case management, and document processing capabilities. Authenticate using
    Bearer tokens created at https://app.penbox.io/workspace/settings/api
servers:
  - url: https://connect.penbox.io/v1
    description: Production
security:
  - BearerAuth: []
paths:
  /webhooks:
    get:
      summary: List Webhooks
      description: >-
        List the webhook endpoints your token registered. Endpoints another
        token registered on the same workspace are not listed.
      operationId: list-webhooks
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookEndpoint'
components:
  schemas:
    WebhookEndpoint:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Endpoint ID
        created_at:
          type: string
          format: date-time
          description: When the endpoint was registered
        workspace:
          type: object
          description: The workspace whose cases this endpoint follows
          properties:
            id:
              type: string
              format: uuid
        url:
          type: string
          format: uri
          description: The HTTPS URL Penbox calls
        events:
          type: array
          items:
            type: string
            enum:
              - case.created
              - case.updated
              - case.deleted
          description: The events sent to this endpoint
        secret:
          type: string
          description: >-
            The secret that signs every call (`Penbox-Signature` header). Keep
            it on your server.
          example: whsec_4f1c…
      required:
        - id
        - workspace
        - url
        - events
        - secret
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token
      description: >-
        API token (starts with pnbx_). Create at
        https://app.penbox.io/workspace/settings/api. Include as: Authorization:
        Bearer {token}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.