Get Connector by ID - API

Retrieves a single connector by its connectorId.

Responses:

• 200 → the connector.
• 404 if no connector matches the ID.

HTTP method and endpoint

GET

|

https://api.videosdk.live/v2/connectors/:connectorId

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 to fetch (the cn_... value).

Response Parameters

data

The connector: id, provider, name, webhookUrl, defaultRoomId, defaultRuleId, region, and createdAt.

GET

|

https://api.videosdk.live/v2/connectors/:connectorId

NodeJS

• cURL
• NodeJS
• PHP
• Python

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

RESPONSE

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