> ## Documentation Index > Fetch the complete documentation index at: https://docs.ibubbl.com/llms.txt > Use this file to discover all available pages before exploring further. # List webhook subscriptions > Returns all currently active webhook subscriptions for the authenticated customer. Revoked subscriptions are omitted — query them by ID directly (`GET /v1/webhooks/{id}`) if you need their history. ### List webhook subscriptions **Method:** `GET` | **Endpoint:** `/v1/webhooks` **Description:** List your account's active webhook subscriptions. Secrets are never returned, only their prefix. **Authentication:** API key in the `Authorization` header: `Authorization: Bearer ib_pk_<64 hex>`. Create keys in the dashboard under **Settings → API access**. #### Request Body None. ```bash cURL theme={null} curl https://api.ibubbl.com/v1/webhooks \ -H "Authorization: Bearer $IBUBBL_API_KEY" ``` ```typescript TypeScript theme={null} const res = await fetch("https://api.ibubbl.com/v1/webhooks", { headers: { Authorization: `Bearer ${process.env.IBUBBL_API_KEY}` }, signal: AbortSignal.timeout(10_000), }); const data = await res.json(); if (!res.ok) throw new Error(`${res.status} ${data.detail?.error}`); for (const sub of data) console.log(sub.id, sub.url, sub.event_types); ``` ```python Python theme={null} import os import requests API_KEY = os.environ["IBUBBL_API_KEY"] res = requests.get( "https://api.ibubbl.com/v1/webhooks", headers={"Authorization": f"Bearer {API_KEY}"}, timeout=10, ) data = res.json() if not res.ok: raise RuntimeError(f"{res.status_code} {data['detail']['error']}") for sub in data: print(sub["id"], sub["url"], sub["event_types"]) ``` ```json 200 OK theme={null} [ { "id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d", "url": "https://api.example.com/ibubbl-webhooks", "secret_prefix": "whsec_a3f2c8d9", "event_types": [ "message.sent", "message.failed", "message.inbound" ], "created_at": "2026-11-05T14:23:45.123Z", "last_delivered_at": "2026-11-05T15:01:12.456Z", "revoked_at": null } ] ``` ```json 401 Unauthorized theme={null} { "detail": { "error": "unauthorized", "message": "Invalid or revoked API key" } } ``` #### Responses **200 OK** ```json theme={null} [ { "id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d", "url": "https://api.example.com/ibubbl-webhooks", "secret_prefix": "whsec_a3f2c8d9", "event_types": [ "message.sent", "message.failed", "message.inbound" ], "created_at": "2026-11-05T14:23:45.123Z", "last_delivered_at": "2026-11-05T15:01:12.456Z", "revoked_at": null } ] ``` Newest first. Revoked subscriptions are left out; an account with none gets `[]`. **401 Unauthorized** ```json theme={null} { "detail": { "error": "unauthorized", "message": "Invalid or revoked API key" } } ``` Other `message` values: `Authorization Bearer token required`, `API key required (use Authorization: Bearer ib_pk_…)`, `Invalid API key format`, `Customer account not found`. **403 Forbidden** ```json theme={null} { "detail": { "error": "forbidden", "message": "Account is suspended" } } ``` Your iBubbl account is suspended or cancelled (`message` is then `Account is cancelled`). Every API-key endpoint returns this. ## OpenAPI ````yaml GET /v1/webhooks openapi: 3.1.0 info: title: iBubbl API version: v1 description: >- The iBubbl REST API. Send iMessages, manage contacts, and subscribe to webhook events from your backend. Authenticate every request with a Bearer API key (`ib_pk_`) — generate one from your dashboard's API Access settings. See the [Authentication](/authentication) guide. servers: - url: https://api.ibubbl.com security: - BearerAuth: [] tags: - name: Messages - name: Contacts - name: Conversations - name: Webhooks - name: Inbound Events paths: /v1/webhooks: get: tags: - Webhooks summary: List webhook subscriptions description: >- Returns all currently active webhook subscriptions for the authenticated customer. Revoked subscriptions are omitted — query them by ID directly (`GET /v1/webhooks/{id}`) if you need their history. operationId: v1_list_webhooks_v1_webhooks_get responses: '200': description: Array of active subscriptions. content: application/json: schema: type: array items: $ref: '#/components/schemas/WebhookSubscription' title: Response V1 List Webhooks V1 Webhooks Get '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: '`forbidden`: your iBubbl account is suspended or cancelled.' content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: WebhookSubscription: properties: id: type: string title: Id description: Unique subscription identifier (UUID). url: type: string title: Url description: The HTTPS URL receiving events. secret_prefix: type: string title: Secret Prefix description: >- First 14 characters of the signing secret (`whsec_` + 8 hex). Useful for identifying which subscription's secret is in use without revealing the full value. The full secret is returned only once, at creation time. examples: - whsec_a3f2c8d9 event_types: anyOf: - items: type: string type: array - type: 'null' title: Event Types description: Event filter, or null if subscribed to all events. created_at: type: string title: Created At description: ISO 8601 UTC timestamp. last_delivered_at: anyOf: - type: string - type: 'null' title: Last Delivered At description: >- ISO 8601 UTC timestamp of the most recent successful delivery to this subscription, or null if no event has been delivered yet. revoked_at: anyOf: - type: string - type: 'null' title: Revoked At description: >- ISO 8601 UTC timestamp the subscription was revoked, or null if active. Revoked subscriptions stop receiving events. type: object required: - id - url - secret_prefix - created_at title: WebhookSubscription example: created_at: '2026-05-17T14:23:45.123Z' event_types: - message.sent - message.failed id: 4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d last_delivered_at: '2026-05-17T15:01:12.456Z' secret_prefix: whsec_a3f2c8d9 url: https://api.example.com/ibubbl-webhooks ApiError: properties: detail: allOf: - $ref: '#/components/schemas/ApiErrorDetail' description: >- Error envelope. Every `/v1` error response wraps a stable `error` code and a human-readable `message` in `detail`. type: object required: - detail title: ApiError example: detail: error: validation_error message: >- Exactly one of contact_id, to, chat_guid, or participant_phones is required ApiErrorDetail: properties: error: type: string title: Error description: >- Stable machine-readable error code. Use this for branching logic in your integration; the human-readable `message` is subject to change. See the Error Reference for the catalog. examples: - validation_error message: type: string title: Message description: Human-readable description of what went wrong. examples: - >- Exactly one of contact_id, to, chat_guid, or participant_phones is required type: object required: - error - message title: ApiErrorDetail securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: ib_pk_<64 hex> description: >- Bearer API key. Format: `Authorization: Bearer ib_pk_<64 hex>` (70 characters). Generate keys from Dashboard → Settings → API Access. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.