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

# List Webhooks

> Return webhook endpoints configured for the authenticated Wachat account. Optionally filter by API instance name.

Return webhook endpoints configured for your Wachat account.

Use `instanceName` only when you want to filter webhooks for one specific `apiInstanceName`.

```bash theme={null}
curl "https://app.wachat.net/api/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash theme={null}
curl "https://app.wachat.net/api/v1/webhooks?instanceName=t1_mq9r2jov_jakarta_store" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

<Note>
  Webhook secrets are masked in list responses. The full secret is returned when creating or updating a webhook.
</Note>


## OpenAPI

````yaml GET /webhooks
openapi: 3.0.3
info:
  title: Wachat Enterprise API
  description: >
    Welcome to the official Wachat API reference. Wachat provides
    developer-friendly, ultra-reliable infrastructure to scale your WhatsApp
    communications programmatically.


    Easily deploy automated messaging pipelines, orchestrate interactive
    customer engagement patterns, verify phone numbers instantly, and control
    containerized WhatsApp instances via a secure, production-grade REST
    architecture.
  version: 1.0.0
servers:
  - url: https://app.wachat.net/api/v1
    description: Live Production Gateway
security:
  - bearerAuth: []
paths:
  /webhooks:
    get:
      tags:
        - Webhooks
      summary: List Webhooks
      description: >-
        Return webhook endpoints configured for the authenticated Wachat
        account. Optionally filter by API instance name.
      parameters:
        - in: query
          name: instanceName
          required: false
          schema:
            type: string
          description: Optional API instance name to filter webhooks by instance.
          example: t1_mq9r2jov_jakarta_store
      responses:
        '200':
          description: Webhooks returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  count:
                    type: integer
                    example: 1
                  webhooks:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookSubscription'
        '401':
          description: Missing or invalid API key.
        '403':
          description: Subscription restriction prevented webhook lookup.
        '404':
          description: Instance not found for this API key.
components:
  schemas:
    WebhookSubscription:
      type: object
      properties:
        id:
          type: integer
          example: 12
        name:
          type: string
          nullable: true
          example: Production webhook
        url:
          type: string
          example: https://example.com/wachat/webhook
        events:
          type: array
          items:
            type: string
          example:
            - messages.upsert
            - connection.update
        enabled:
          type: boolean
          example: true
        secret:
          type: string
          description: >-
            Masked in list responses. Returned in full when creating or updating
            a webhook.
          example: whsec_••••abcdef
        instance:
          type: object
          nullable: true
          properties:
            instanceName:
              type: string
              example: jakarta_store
            displayName:
              type: string
              example: jakarta_store
            apiInstanceName:
              type: string
              example: t1_mq9r2jov_jakarta_store
            internalName:
              type: string
              example: t1_mq9r2jov_jakarta_store
        createdAt:
          type: string
          format: date-time
          example: '2026-06-13T08:00:00.000Z'
        updatedAt:
          type: string
          format: date-time
          example: '2026-06-13T08:00:00.000Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authenticate your integration payloads by injecting your premium secure
        Wachat Account API Private Secret Key inside standard Authorization
        Bearer header vectors.

````