POST
/
v2
/
conversations
curl --request POST \
  --url https://tavusapi.com/v2/conversations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "replica_id": "r79e1c033f",
  "persona_id": "p5317866",
  "callback_url": "https://yourwebsite.com/webhook",
  "conversation_name": "A Meeting with Hassaan",
  "conversational_context": "You are about to talk to Hassaan, one of the cofounders of Tavus. He loves to talk about AI, startups, and racing cars.",
  "custom_greeting": "Hey there Hassaan, long time no see!",
  "properties": {
    "max_call_duration": 3600,
    "participant_left_timeout": 60,
    "participant_absent_timeout": 300,
    "enable_recording": true,
    "enable_closed_captions": true,
    "apply_greenscreen": true,
    "language": "english",
    "recording_s3_bucket_name": "conversation-recordings",
    "recording_s3_bucket_region": "us-east-1",
    "aws_assume_role_arn": ""
  }
}'
{
  "conversation_id": "c123456",
  "conversation_name": "A Meeting with Hassaan",
  "status": "active",
  "conversation_url": "https://tavus.daily.co/c123456",
  "replica_id": "r79e1c033f",
  "persona_id": "p5317866",
  "created_at": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Response

200 - application/json

The response is of type object.