Agents Platform

Handle An Outbound Call Via Sip Trunk

Changed on

Handle an outbound call via SIP trunk

post/v1/convai/sip-trunk/outbound-call

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/convai/sip-trunk/outbound-call
  • Auth
    none declared

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body

agent_idstring required
agent_phone_number_idstring required
to_numberstring required

Example request

{
  "conversation_initiation_client_data": {
    "conversation_config_override": {
      "agent": {
        "first_message": "Hello, how can I help you today?",
        "language": "en",
        "prompt": {
          "knowledge_base": [],
          "llm": "gemini-2.0-flash-001",
          "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
          "tool_ids": []
        }
      },
      "asr": {
        "keywords": [
          "hello",
          "world"
        ]
      },
      "conversation": {
        "max_duration_seconds": 600
      },
      "tts": {
        "model_id": "eleven_turbo_v2",
        "pronunciation_dictionary_locators": [],
        "similarity_boost": 0.8,
        "speed": 1,
        "stability": 0.5,
        "voice_id": "cjVigY5qzO86Huf0OWal"
      },
      "turn": {
        "soft_timeout_config": {
          "message": "Hhmmmm...yeah."
        }
      }
    }
  }
}

Response

Successful Response

successboolean required
messagestring required
conversation_idstring nullable required
sip_call_idstring nullable required

Changes

  • 61de2e1f86c1Revision changes
    • info

      added the new optional request property //

  • 186289924667Revision changes
    • info

      added the new optional request property ///