Skip to main content
POST
/
orgs
/
{org_id}
/
webhooks
Create webhook
import requests

url = "https://vued-office-api-dev.onrender.com/v1/orgs/{org_id}/webhooks"

payload = {
    "url": "<string>",
    "events": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)
{
  "id": 123,
  "object": "webhook",
  "name": "<string>",
  "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "url": "<string>",
  "events": [],
  "payload_fields": {},
  "created_at": "<string>",
  "disabled": true,
  "fail_count": 123,
  "last_delivery_at": "<string>",
  "last_success_at": "<string>",
  "last_failure_at": "<string>",
  "last_error": "<string>",
  "secret": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

org_id
string<uuid>
required

Body

application/json
url
string<uri>
required
events
enum<string>[]
required
Available options:
meeting.started,
meeting.ended,
meeting.transcription.completed,
meeting.speaker_id.completed,
meeting.finalized,
meeting.automatic.surfaced
name
string
default:Webhook
payload_fields
disabled
boolean
default:false

Response

200 - application/json

Created webhook with one-time secret.

id
integer
object
enum<string>
Available options:
webhook
name
string
org_id
string<uuid>
created_by
string<uuid>
url
string<uri>
events
enum<string>[]
Available options:
meeting.started,
meeting.ended,
meeting.transcription.completed,
meeting.speaker_id.completed,
meeting.finalized,
meeting.automatic.surfaced
payload_fields
object
created_at
string
disabled
boolean
fail_count
integer
last_delivery_at
string | null
last_success_at
string | null
last_failure_at
string | null
last_error
string | null
secret
string

Signing secret. Present only on create.

Last modified on June 29, 2026