Create a new meeting
curl --request POST \
--url https://api.waterr.ai/v1/meetings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"person_name": "<string>",
"scenario_id": "<string>",
"email": "<string>",
"meeting_title": "<string>",
"meeting_duration_minutes": 120,
"voice_id": "<string>",
"note_context": "<string>",
"system_prompt": "<string>",
"welcome_message": "<string>",
"language": "Hindi",
"bot_persona": "<string>",
"controls": {
"allow_recording": true,
"allow_transcription": true,
"allow_chat": true,
"allow_screen_share": true,
"allow_participant_video": true,
"allow_participant_audio": true,
"waiting_room_enabled": true,
"auto_admit": true,
"max_participants": 50,
"end_call_enabled": true,
"process_camera_feed": true,
"process_screen_share": true,
"use_gpt_vision": true,
"allow_web_search": true,
"deep_think": true,
"enable_participant_memory": true,
"live_demo_links": [
"<string>"
]
},
"custom_agent": {
"base_url": "<string>",
"api_key": "<string>",
"model": "<string>"
},
"end_user_id": "<string>",
"user_memory_tag": "<string>"
}
'import requests
url = "https://api.waterr.ai/v1/meetings"
payload = {
"person_name": "<string>",
"scenario_id": "<string>",
"email": "<string>",
"meeting_title": "<string>",
"meeting_duration_minutes": 120,
"voice_id": "<string>",
"note_context": "<string>",
"system_prompt": "<string>",
"welcome_message": "<string>",
"language": "Hindi",
"bot_persona": "<string>",
"controls": {
"allow_recording": True,
"allow_transcription": True,
"allow_chat": True,
"allow_screen_share": True,
"allow_participant_video": True,
"allow_participant_audio": True,
"waiting_room_enabled": True,
"auto_admit": True,
"max_participants": 50,
"end_call_enabled": True,
"process_camera_feed": True,
"process_screen_share": True,
"use_gpt_vision": True,
"allow_web_search": True,
"deep_think": True,
"enable_participant_memory": True,
"live_demo_links": ["<string>"]
},
"custom_agent": {
"base_url": "<string>",
"api_key": "<string>",
"model": "<string>"
},
"end_user_id": "<string>",
"user_memory_tag": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
person_name: '<string>',
scenario_id: '<string>',
email: '<string>',
meeting_title: '<string>',
meeting_duration_minutes: 120,
voice_id: '<string>',
note_context: '<string>',
system_prompt: '<string>',
welcome_message: '<string>',
language: 'Hindi',
bot_persona: '<string>',
controls: {
allow_recording: true,
allow_transcription: true,
allow_chat: true,
allow_screen_share: true,
allow_participant_video: true,
allow_participant_audio: true,
waiting_room_enabled: true,
auto_admit: true,
max_participants: 50,
end_call_enabled: true,
process_camera_feed: true,
process_screen_share: true,
use_gpt_vision: true,
allow_web_search: true,
deep_think: true,
enable_participant_memory: true,
live_demo_links: ['<string>']
},
custom_agent: {base_url: '<string>', api_key: '<string>', model: '<string>'},
end_user_id: '<string>',
user_memory_tag: '<string>'
})
};
fetch('https://api.waterr.ai/v1/meetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.waterr.ai/v1/meetings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'person_name' => '<string>',
'scenario_id' => '<string>',
'email' => '<string>',
'meeting_title' => '<string>',
'meeting_duration_minutes' => 120,
'voice_id' => '<string>',
'note_context' => '<string>',
'system_prompt' => '<string>',
'welcome_message' => '<string>',
'language' => 'Hindi',
'bot_persona' => '<string>',
'controls' => [
'allow_recording' => true,
'allow_transcription' => true,
'allow_chat' => true,
'allow_screen_share' => true,
'allow_participant_video' => true,
'allow_participant_audio' => true,
'waiting_room_enabled' => true,
'auto_admit' => true,
'max_participants' => 50,
'end_call_enabled' => true,
'process_camera_feed' => true,
'process_screen_share' => true,
'use_gpt_vision' => true,
'allow_web_search' => true,
'deep_think' => true,
'enable_participant_memory' => true,
'live_demo_links' => [
'<string>'
]
],
'custom_agent' => [
'base_url' => '<string>',
'api_key' => '<string>',
'model' => '<string>'
],
'end_user_id' => '<string>',
'user_memory_tag' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.waterr.ai/v1/meetings"
payload := strings.NewReader("{\n \"person_name\": \"<string>\",\n \"scenario_id\": \"<string>\",\n \"email\": \"<string>\",\n \"meeting_title\": \"<string>\",\n \"meeting_duration_minutes\": 120,\n \"voice_id\": \"<string>\",\n \"note_context\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"language\": \"Hindi\",\n \"bot_persona\": \"<string>\",\n \"controls\": {\n \"allow_recording\": true,\n \"allow_transcription\": true,\n \"allow_chat\": true,\n \"allow_screen_share\": true,\n \"allow_participant_video\": true,\n \"allow_participant_audio\": true,\n \"waiting_room_enabled\": true,\n \"auto_admit\": true,\n \"max_participants\": 50,\n \"end_call_enabled\": true,\n \"process_camera_feed\": true,\n \"process_screen_share\": true,\n \"use_gpt_vision\": true,\n \"allow_web_search\": true,\n \"deep_think\": true,\n \"enable_participant_memory\": true,\n \"live_demo_links\": [\n \"<string>\"\n ]\n },\n \"custom_agent\": {\n \"base_url\": \"<string>\",\n \"api_key\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"end_user_id\": \"<string>\",\n \"user_memory_tag\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.waterr.ai/v1/meetings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"person_name\": \"<string>\",\n \"scenario_id\": \"<string>\",\n \"email\": \"<string>\",\n \"meeting_title\": \"<string>\",\n \"meeting_duration_minutes\": 120,\n \"voice_id\": \"<string>\",\n \"note_context\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"language\": \"Hindi\",\n \"bot_persona\": \"<string>\",\n \"controls\": {\n \"allow_recording\": true,\n \"allow_transcription\": true,\n \"allow_chat\": true,\n \"allow_screen_share\": true,\n \"allow_participant_video\": true,\n \"allow_participant_audio\": true,\n \"waiting_room_enabled\": true,\n \"auto_admit\": true,\n \"max_participants\": 50,\n \"end_call_enabled\": true,\n \"process_camera_feed\": true,\n \"process_screen_share\": true,\n \"use_gpt_vision\": true,\n \"allow_web_search\": true,\n \"deep_think\": true,\n \"enable_participant_memory\": true,\n \"live_demo_links\": [\n \"<string>\"\n ]\n },\n \"custom_agent\": {\n \"base_url\": \"<string>\",\n \"api_key\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"end_user_id\": \"<string>\",\n \"user_memory_tag\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.waterr.ai/v1/meetings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"person_name\": \"<string>\",\n \"scenario_id\": \"<string>\",\n \"email\": \"<string>\",\n \"meeting_title\": \"<string>\",\n \"meeting_duration_minutes\": 120,\n \"voice_id\": \"<string>\",\n \"note_context\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"language\": \"Hindi\",\n \"bot_persona\": \"<string>\",\n \"controls\": {\n \"allow_recording\": true,\n \"allow_transcription\": true,\n \"allow_chat\": true,\n \"allow_screen_share\": true,\n \"allow_participant_video\": true,\n \"allow_participant_audio\": true,\n \"waiting_room_enabled\": true,\n \"auto_admit\": true,\n \"max_participants\": 50,\n \"end_call_enabled\": true,\n \"process_camera_feed\": true,\n \"process_screen_share\": true,\n \"use_gpt_vision\": true,\n \"allow_web_search\": true,\n \"deep_think\": true,\n \"enable_participant_memory\": true,\n \"live_demo_links\": [\n \"<string>\"\n ]\n },\n \"custom_agent\": {\n \"base_url\": \"<string>\",\n \"api_key\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"end_user_id\": \"<string>\",\n \"user_memory_tag\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyMeetings
Create a new meeting
POST
/
meetings
Create a new meeting
curl --request POST \
--url https://api.waterr.ai/v1/meetings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"person_name": "<string>",
"scenario_id": "<string>",
"email": "<string>",
"meeting_title": "<string>",
"meeting_duration_minutes": 120,
"voice_id": "<string>",
"note_context": "<string>",
"system_prompt": "<string>",
"welcome_message": "<string>",
"language": "Hindi",
"bot_persona": "<string>",
"controls": {
"allow_recording": true,
"allow_transcription": true,
"allow_chat": true,
"allow_screen_share": true,
"allow_participant_video": true,
"allow_participant_audio": true,
"waiting_room_enabled": true,
"auto_admit": true,
"max_participants": 50,
"end_call_enabled": true,
"process_camera_feed": true,
"process_screen_share": true,
"use_gpt_vision": true,
"allow_web_search": true,
"deep_think": true,
"enable_participant_memory": true,
"live_demo_links": [
"<string>"
]
},
"custom_agent": {
"base_url": "<string>",
"api_key": "<string>",
"model": "<string>"
},
"end_user_id": "<string>",
"user_memory_tag": "<string>"
}
'import requests
url = "https://api.waterr.ai/v1/meetings"
payload = {
"person_name": "<string>",
"scenario_id": "<string>",
"email": "<string>",
"meeting_title": "<string>",
"meeting_duration_minutes": 120,
"voice_id": "<string>",
"note_context": "<string>",
"system_prompt": "<string>",
"welcome_message": "<string>",
"language": "Hindi",
"bot_persona": "<string>",
"controls": {
"allow_recording": True,
"allow_transcription": True,
"allow_chat": True,
"allow_screen_share": True,
"allow_participant_video": True,
"allow_participant_audio": True,
"waiting_room_enabled": True,
"auto_admit": True,
"max_participants": 50,
"end_call_enabled": True,
"process_camera_feed": True,
"process_screen_share": True,
"use_gpt_vision": True,
"allow_web_search": True,
"deep_think": True,
"enable_participant_memory": True,
"live_demo_links": ["<string>"]
},
"custom_agent": {
"base_url": "<string>",
"api_key": "<string>",
"model": "<string>"
},
"end_user_id": "<string>",
"user_memory_tag": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
person_name: '<string>',
scenario_id: '<string>',
email: '<string>',
meeting_title: '<string>',
meeting_duration_minutes: 120,
voice_id: '<string>',
note_context: '<string>',
system_prompt: '<string>',
welcome_message: '<string>',
language: 'Hindi',
bot_persona: '<string>',
controls: {
allow_recording: true,
allow_transcription: true,
allow_chat: true,
allow_screen_share: true,
allow_participant_video: true,
allow_participant_audio: true,
waiting_room_enabled: true,
auto_admit: true,
max_participants: 50,
end_call_enabled: true,
process_camera_feed: true,
process_screen_share: true,
use_gpt_vision: true,
allow_web_search: true,
deep_think: true,
enable_participant_memory: true,
live_demo_links: ['<string>']
},
custom_agent: {base_url: '<string>', api_key: '<string>', model: '<string>'},
end_user_id: '<string>',
user_memory_tag: '<string>'
})
};
fetch('https://api.waterr.ai/v1/meetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.waterr.ai/v1/meetings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'person_name' => '<string>',
'scenario_id' => '<string>',
'email' => '<string>',
'meeting_title' => '<string>',
'meeting_duration_minutes' => 120,
'voice_id' => '<string>',
'note_context' => '<string>',
'system_prompt' => '<string>',
'welcome_message' => '<string>',
'language' => 'Hindi',
'bot_persona' => '<string>',
'controls' => [
'allow_recording' => true,
'allow_transcription' => true,
'allow_chat' => true,
'allow_screen_share' => true,
'allow_participant_video' => true,
'allow_participant_audio' => true,
'waiting_room_enabled' => true,
'auto_admit' => true,
'max_participants' => 50,
'end_call_enabled' => true,
'process_camera_feed' => true,
'process_screen_share' => true,
'use_gpt_vision' => true,
'allow_web_search' => true,
'deep_think' => true,
'enable_participant_memory' => true,
'live_demo_links' => [
'<string>'
]
],
'custom_agent' => [
'base_url' => '<string>',
'api_key' => '<string>',
'model' => '<string>'
],
'end_user_id' => '<string>',
'user_memory_tag' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.waterr.ai/v1/meetings"
payload := strings.NewReader("{\n \"person_name\": \"<string>\",\n \"scenario_id\": \"<string>\",\n \"email\": \"<string>\",\n \"meeting_title\": \"<string>\",\n \"meeting_duration_minutes\": 120,\n \"voice_id\": \"<string>\",\n \"note_context\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"language\": \"Hindi\",\n \"bot_persona\": \"<string>\",\n \"controls\": {\n \"allow_recording\": true,\n \"allow_transcription\": true,\n \"allow_chat\": true,\n \"allow_screen_share\": true,\n \"allow_participant_video\": true,\n \"allow_participant_audio\": true,\n \"waiting_room_enabled\": true,\n \"auto_admit\": true,\n \"max_participants\": 50,\n \"end_call_enabled\": true,\n \"process_camera_feed\": true,\n \"process_screen_share\": true,\n \"use_gpt_vision\": true,\n \"allow_web_search\": true,\n \"deep_think\": true,\n \"enable_participant_memory\": true,\n \"live_demo_links\": [\n \"<string>\"\n ]\n },\n \"custom_agent\": {\n \"base_url\": \"<string>\",\n \"api_key\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"end_user_id\": \"<string>\",\n \"user_memory_tag\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.waterr.ai/v1/meetings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"person_name\": \"<string>\",\n \"scenario_id\": \"<string>\",\n \"email\": \"<string>\",\n \"meeting_title\": \"<string>\",\n \"meeting_duration_minutes\": 120,\n \"voice_id\": \"<string>\",\n \"note_context\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"language\": \"Hindi\",\n \"bot_persona\": \"<string>\",\n \"controls\": {\n \"allow_recording\": true,\n \"allow_transcription\": true,\n \"allow_chat\": true,\n \"allow_screen_share\": true,\n \"allow_participant_video\": true,\n \"allow_participant_audio\": true,\n \"waiting_room_enabled\": true,\n \"auto_admit\": true,\n \"max_participants\": 50,\n \"end_call_enabled\": true,\n \"process_camera_feed\": true,\n \"process_screen_share\": true,\n \"use_gpt_vision\": true,\n \"allow_web_search\": true,\n \"deep_think\": true,\n \"enable_participant_memory\": true,\n \"live_demo_links\": [\n \"<string>\"\n ]\n },\n \"custom_agent\": {\n \"base_url\": \"<string>\",\n \"api_key\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"end_user_id\": \"<string>\",\n \"user_memory_tag\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.waterr.ai/v1/meetings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"person_name\": \"<string>\",\n \"scenario_id\": \"<string>\",\n \"email\": \"<string>\",\n \"meeting_title\": \"<string>\",\n \"meeting_duration_minutes\": 120,\n \"voice_id\": \"<string>\",\n \"note_context\": \"<string>\",\n \"system_prompt\": \"<string>\",\n \"welcome_message\": \"<string>\",\n \"language\": \"Hindi\",\n \"bot_persona\": \"<string>\",\n \"controls\": {\n \"allow_recording\": true,\n \"allow_transcription\": true,\n \"allow_chat\": true,\n \"allow_screen_share\": true,\n \"allow_participant_video\": true,\n \"allow_participant_audio\": true,\n \"waiting_room_enabled\": true,\n \"auto_admit\": true,\n \"max_participants\": 50,\n \"end_call_enabled\": true,\n \"process_camera_feed\": true,\n \"process_screen_share\": true,\n \"use_gpt_vision\": true,\n \"allow_web_search\": true,\n \"deep_think\": true,\n \"enable_participant_memory\": true,\n \"live_demo_links\": [\n \"<string>\"\n ]\n },\n \"custom_agent\": {\n \"base_url\": \"<string>\",\n \"api_key\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"end_user_id\": \"<string>\",\n \"user_memory_tag\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
API key from waterr.ai/settings?tab=api-keys. Send as Authorization: Bearer wai_<your_key>.
Body
application/json
Name of the participant joining the session. The agent greets and addresses them by it, and it labels the call in transcripts, analyses and memory. If you don't know who will join yet, send "Guest".
UUID of the scenario to use. The scenario must exist or the request is rejected with 404.
The participant's email. Fills {{USER_EMAIL}} / {userEmail} in the prompt and welcome message.
Maximum string length:
254Title for this call in meeting lists and analyses. Defaults to the scenario name.
Maximum string length:
200Length of this call. Anyone can shorten it; only your own workspace can run its scenarios past their saved length. Your plan's call cap still applies.
Required range:
1 <= x <= 240Optional override for the persona's voice.
Defaults to "regular".
Available options:
regular, instant Session-specific context injected into the AI prompt without modifying the scenario.
Replaces the scenario's prompt for this call only; the saved scenario is not changed. Persona, voice, knowledge base, tools and other settings still apply, and note_context is still added on top. Plain text or POML. Your own workspace's scenarios only (403 otherwise).
Maximum string length:
65536The agent's first line for this call. Your own workspace's scenarios only.
Maximum string length:
2000The call's language; the voice follows it. Your own workspace's scenarios only.
Example:
"Hindi"
The name the agent goes by in this call. Your own workspace's scenarios only.
Maximum string length:
80Overrides the scenario's meeting settings for this call. Only the keys you send change; unknown keys are rejected. A capability your plan doesn't include is switched off. Your own workspace's scenarios only.
Show child attributes
Show child attributes
Bring-your-own-agent endpoint for this call. Your own workspace's scenarios only.
Show child attributes
Show child attributes
For end-user sessions; pairs the meeting with an existing end_user membership.
The memory container this call reads at start and adds to at end, when the scenario has memory on. Defaults to the participant's own identity.
Maximum string length:
128Response
Meeting created successfully