---
title: "Create webhooks"
method: POST
path: "/api/v2/webhookEndpoints"
tags: ["Webhooks"]
---

# Create webhooks

`POST /api/v2/webhookEndpoints`

## Request body

- object[]
  - `phoneNumber` string
  - `status` integer — Webhook status type: 0 = Disabled, 1 = Enabled, 2 = Defective.
  - `url` string
  - `eventTypes` string[]

## Response `200`

Create webhooks success

- object
  - `ok` boolean — Indicates whether webhook creation was successful.
  - `result` object[] — List of created or existing webhook endpoint configurations.
    - `id` string — Unique identifier of the webhook endpoint.
    - `tenantId` string — Tenant identifier that owns this webhook endpoint.
    - `channelId` string — Channel ID associated with this webhook, indicating which WhatsApp channel it belongs to.
    - `channelPhoneNumber` string — Phone number of the channel for which this webhook is configured.
    - `url` string — Destination URL where webhook events will be delivered.
    - `status` integer — Status code of the webhook endpoint (e.g. 0 for active).
    - `created` string — Creation timestamp of the webhook endpoint.
    - `lastUpdated` string — Last update timestamp of the webhook endpoint.
    - `failedIterationCount` integer — Number of consecutive failed attempts for this webhook.
    - `isSentNotify` boolean — Indicates whether a failure notification has been sent.
    - `eventTypes` string[] — List of event types that will trigger this webhook (e.g. 'message', 'newContactMessageReceived').

---

[API](https://skmtc.dev/wati/apis/api-documentation-v3.md) · [All operations](https://skmtc.dev/wati/apis/api-documentation-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wati/api-documentation-v3/revisions/dee16d2c7d41/schema)