---
title: "Update webhook"
method: PUT
path: "/v2/webhooks/{webhook_id}"
tags: ["Webhook"]
---

# Update webhook

`PUT /v2/webhooks/{webhook_id}`

Update a webhook by its Id.

## Path parameters

- `webhook_id` string, required

## Request body

- object
  - `url` string, required — Webhook url.
  - `event` object, required
    - `event` 'on_broadcast_new_feedback' | 'on_broadcast_pub_connected' | 'on_broadcast_pub_disconnected' | 'on_broadcast_recording_available' | 'on_broadcast_start' | 'on_broadcast_stop' | 'on_broadcast_sub_connected' | 'on_broadcast_sub_disconnected' | 'on_call_ended' | 'on_call_incoming' | 'on_message_sent' | 'on_missed_call' | 'on_recording_available' | 'on_recording_started' | 'on_recording_stopped' | 'on_room_created' | 'on_room_deleted' | 'on_room_disabled' | 'on_room_new_feedback' | 'on_session_ended' | 'on_session_paused' | 'on_session_resumed' | 'on_session_started' | 'on_upload_tag_added' | 'on_upload_tag_removed' | 'on_user_connected' | 'on_user_disconnected' | 'on_signature_enveloped_inserted' | 'on_transcription_available' | 'on_summarization_available' — Event name.
    - `version` '0.1' | '1.0' | '2.0' — should be version so "0.1" or "1.0" or "2.x" are allowed
  - `version` '0.1' | '1.0' | '2.0', required — should be version so "0.1" or "1.0" or "2.x" are allowed

## Response `200`

- object
  - `id` string — Webhook Id.
  - `url` string — Webhook url.
  - `event` 'on_broadcast_new_feedback' | 'on_broadcast_pub_connected' | 'on_broadcast_pub_disconnected' | 'on_broadcast_recording_available' | 'on_broadcast_start' | 'on_broadcast_stop' | 'on_broadcast_sub_connected' | 'on_broadcast_sub_disconnected' | 'on_call_ended' | 'on_call_incoming' | 'on_message_sent' | 'on_missed_call' | 'on_recording_available' | 'on_recording_started' | 'on_recording_stopped' | 'on_room_created' | 'on_room_deleted' | 'on_room_disabled' | 'on_room_new_feedback' | 'on_session_ended' | 'on_session_paused' | 'on_session_resumed' | 'on_session_started' | 'on_upload_tag_added' | 'on_upload_tag_removed' | 'on_user_connected' | 'on_user_disconnected' | 'on_signature_enveloped_inserted' | 'on_transcription_available' | 'on_summarization_available' — Event name.
  - `version` '0.1' | '1.0' | '2.0' — should be version so "0.1" or "1.0" or "2.x" are allowed
  - `active` boolean — Indicates if a webhook is active or not.
  - `creation_date` string, date-time — Creation date of a webhook.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Webhook not found
- `422` — Unprocessable Content
- `429` — Too Many request

---

[API](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis.md) · [All operations](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kaleyra/kaleyra-io-sms-apis/versions/d9b785884d03/schema)