---
title: "Update Webhook Configuration"
method: POST
path: "/v3/metainfo/webhook/update_webhook"
tags: ["Webhook Management"]
---

# Update Webhook Configuration

`POST /v3/metainfo/webhook/update_webhook`

## Request

- Base URL: `https://cpaaswa.netcorecloud.net/api`
- URL: `https://cpaaswa.netcorecloud.net/api/v3/metainfo/webhook/update_webhook`
- Auth: HTTP bearer

Use this API to create or update webhook configurations.  
Set the webhook URL, custom headers, and alert email settings.

**Limits**
- Up to **3 incoming** and **5 event** webhooks.

## Headers

- `Content-Type` string, required

## Request body

- UpdateWebhookRequest
  - `type` 'incoming' | 'event', required: Select whether the webhook is for incoming messages or event delivery.
  - `name` string, required: Enter a unique name for the webhook.
  - `url` string, uri, required: Enter the destination URL to receive webhook payloads.
  - `source` string: Optionally specify the source or service that owns the webhook.
  - `headers` string, required: Provide custom headers in JSON format for webhook requests.

## Response `200`

**Success Response**

Webhook configuration updated successfully.

```json
{
  "status": "success",
  "message": "Webhook updated successfully.",
  "data": {
    "webhook_name": "ChatBot_Webhook",
    "type": "incoming"
  }
}
```

- WebhookOperationResponse
  - `status` 'success' | 'failure', required: Indicates if the operation was successful.
  - `message` string, required: Message describing the operation result.
  - `data` object: Includes webhook operation details.
    - `webhook_name` string
    - `type` string
    - `status` string

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `500`: **Webhook Limit Exceeded** The maximum number of webhooks for this type has been reached. ```json { "status": "failure", "message": "Max allowed incoming events exceeded" } ```

---

[API](https://skmtc.dev/netcorecloud/apis/whatsapp-api.md) - [All operations](https://skmtc.dev/netcorecloud/apis/whatsapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/whatsapp-api/revisions/82cdf689fb7a?raw)