Skip to main content
POST
Create a new meeting

Authorizations

Authorization
string
header
required

API key from waterr.ai/settings?tab=api-keys. Send as Authorization: Bearer wai_<your_key>.

Body

application/json
person_name
string
required

Name of the participant joining the session.

scenario_id
string
required

UUID of the scenario to use. The scenario must exist or the request is rejected with 404.

voice_id
string

Optional override for the persona's voice.

meeting_type
enum<string>

Defaults to "regular".

Available options:
regular,
instant
note_context
string

Session-specific context injected into the AI prompt without modifying the scenario.

end_user_id
string

For end-user sessions; pairs the meeting with an existing end_user membership.

Response

Meeting created successfully