Generate a Voice AI webhook signing secret

Generates and stores an encrypted X-Vapi-Secret value for signed Voice AI ingest. SaaS owner access and a verified user session required; no selected workspace membership is needed.

POST

https://api.channelautomation.com/api/voice-ai-provisioning/workspaces/{workspaceId}/webhook-secret

Authorization

BearerAuth
HTTP Bearer (JWT)
required

Path parameters

workspaceId
string
required
Workspace ID to configure.

Request body JSON optional

rotate
optional
boolean
Set true to replace an existing signing secret.

Returns

200

Signing secret generated and stored.

400

Invalid request.

401

Authentication required

JSON

error
optional
string
success
optional
boolean

403

SaaS owner access required.

409

Secret already exists and rotate was not set.

500

Internal server error

JSON

error
optional
string
details
optional
string
success
optional
boolean

503

Identity verification unavailable.

Generate a Voice AI webhook signing secret

curl --request POST \
  --url 'https://api.channelautomation.com/api/voice-ai-provisioning/workspaces/<workspaceId>/webhook-secret' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rotate": true
}'

const url = 'https://api.channelautomation.com/api/voice-ai-provisioning/workspaces/<workspaceId>/webhook-secret';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({rotate: true})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/voice-ai-provisioning/workspaces/<workspaceId>/webhook-secret"

payload = { "rotate": True }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "error": "Authentication required",
  "success": false
}

{
  "error": "Internal server error",
  "details": "string",
  "success": false
}