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

# List Webhooks

> List all registered webhooks for your organization.

## Basic Usage

```bash theme={null}
curl "https://api.flowiq.live/get-webhooks" \
  -H "Authorization: Bearer fiq_YOUR_API_KEY"
```

### Filter by Platform

```bash theme={null}
curl "https://api.flowiq.live/get-webhooks?platform=whatsapp" \
  -H "Authorization: Bearer fiq_YOUR_API_KEY"
```

***

## Query Parameters

| Parameter  | Required | Description                          |
| ---------- | -------- | ------------------------------------ |
| `platform` | No       | Filter by platform (e.g. `whatsapp`) |

***

## Response

```json theme={null}
{
  "success": true,
  "count": 2,
  "webhooks": [
    {
      "id": "0df9d480-f181-466b-ae8d-85216c16e8dd",
      "url": "https://your-server.com/webhook",
      "type": "message_received",
      "platform": "whatsapp",
      "created_at": "2026-03-04T00:03:57.023943+02:00"
    }
  ]
}
```


## OpenAPI

````yaml GET /get-webhooks
openapi: 3.1.0
info:
  title: FlowIQ Conversations API
  version: 1.0.0
  description: >-
    Complete WhatsApp Conversations API for retrieving messages, contacts, and
    conversation history.


    ## Authentication

    All endpoints require a Bearer token in the header:

    ```

    Authorization: Bearer YOUR_BEARER_TOKEN

    ```


    ## Example API Call

    ```bash

    curl -X GET
    "https://api.flowiq.live/conversations?whatsappNumber=27123456789&limit=10"
    \
      -H "Authorization: Bearer YOUR_BEARER_TOKEN"
    ```


    **Response:**

    ```json

    {
      "success": true,
      "messages": [...],
      "pagination": {
        "currentPage": 1,
        "totalPages": 5,
        "hasNextPage": true
      },
      "count": 10
    }

    ```
  contact:
    name: FlowIQ Support
    email: dev@flowapt.com
servers:
  - url: https://api.flowiq.live
    description: FlowIQ Production API
security:
  - BearerAuth: []
tags:
  - name: Endpoints
    description: Conversation and contact management API endpoints
  - name: Webhooks
    description: Webhook registration and management
paths:
  /get-webhooks:
    get:
      tags:
        - Webhooks
      summary: List Webhooks
      description: List all registered webhooks for your organization.
      operationId: getWebhooks
      parameters:
        - name: platform
          in: query
          required: false
          schema:
            type: string
            example: whatsapp
          description: Filter by platform (e.g. `whatsapp`)
      responses:
        '200':
          description: Webhooks retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  count:
                    type: integer
                  webhooks:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        url:
                          type: string
                        type:
                          type: string
                        platform:
                          type: string
                        created_at:
                          type: string
                          format: date-time
              example:
                success: true
                count: 1
                webhooks:
                  - id: 0df9d480-f181-466b-ae8d-85216c16e8dd
                    url: https://your-server.com/webhook
                    type: message_received
                    platform: whatsapp
                    created_at: '2026-03-04T00:03:57.023943+02:00'
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Bearer token for authentication. Format: `Bearer YOUR_BEARER_TOKEN`'
      bearerFormat: JWT

````