Rotate Webhook Key - API

Generates a new webhook key for the connector and returns an updated webhookUrl. The previous webhook URL stops working immediately, so update your provider console with the new URL right after rotating.

Responses:

• 200 → the connector with its new webhookUrl.
• 404 if no connector matches the ID.

HTTP method and endpoint

POST

|

https://api.videosdk.live/v2/connectors/:connectorId/rotate-key

Headers Parameters

Authorization

REQUIRED

values: YOUR_TOKEN_WITHOUT_ANY_PREFIX

This will be a JWT token generate using VideoSDK ApiKey and Secret.

Note that the token will not include any prefix such as "Basic " or "Bearer ". Just pass a token as value.

You can generate a new token by refering this Guide: Generate Auth token

Parameters

connectorId

REQUIRED

ID of the connector whose webhook key you want to rotate.

Response Parameters

data

The connector with a freshly generated webhookUrl.

POST

|

https://api.videosdk.live/v2/connectors/:connectorId/rotate-key

NodeJS

• cURL
• NodeJS
• PHP
• Python

import fetch from 'node-fetch';
const options = {
	method: "POST",
	headers: {
		"Authorization": "$YOUR_TOKEN",
	},
};
const url= `https://api.videosdk.live/v2/connectors/:connectorId/rotate-key`;
const response = await fetch(url, options);
const data = await response.json();
console.log(data);

RESPONSE

{
  "message": "Webhook key rotated successfully",
  "data": {
    "id": "cn_a7k2m9x5p3q8r1v0",
    "provider": "twilio",
    "name": "Main Twilio Connector",
    "webhookUrl": "https://api.videosdk.live/v2/hooks/twilio/whk_2Np6rT8mK1xL5vD9yB3qC7hW4gZ0fS6",
    "defaultRoomId": "abcd-efgh-ijkl",
    "defaultRuleId": null,
    "region": "us002",
    "createdAt": "2026-06-21T14:30:45.123Z"
  }
}