• Assistants
      • List all assistants
      • Create a new assistant
      • Get an assistant
      • Update an assistant
      • Delete an assistant
    • Tool Templates
      • List all tool templates
      • Create a new tool template
      • Get a tool template
      • Update a tool template
      • Delete a tool template
    • Numbers
      • List all phone numbers
      • Register a phone number
      • Get a phone number
      • Update a phone number
      • Delete a phone number
    • Calls
      • List calls
      • Get call by ID
      • Initiate outbound call
    • Call Control
      • Send control command to active call
    • Usage
      • Get usage logs
    • SIP Trunks
      • List SIP trunks
      • Create a SIP trunk
      • Get a SIP trunk
      • Delete a SIP trunk
    • Voices
      • List available voices
    • BYOK
      • Get BYOK configurations
      • Add BYOK configuration
      • Delete BYOK configuration
      • Get BYOK provider configurations
    • Domains
      • Get your domain
      • Add a domain
      • Delete your domain
      • List available Resend domains
      • Select and sync a Resend domain
      • Verify domain DNS records
      • Refresh domain status
    • Webhooks
      • Dynamic assistant configuration webhook
      • Tool/Function Call
      • Call Status Update
      • End of Call Report
    • Analysis Templates
      • List analysis templates
      • Create analysis template
      • Get analysis template
      • Update analysis template
      • Delete analysis template
    • Organization
      • Get organization information
      • Create organization
      • Get organization information (deprecated)
    • Campaigns
      • List all campaigns
      • Create a campaign
      • Get a campaign
      • Update a campaign
      • Delete a campaign
      • List campaign leads
      • Add a lead
      • Remove a lead
    • Agents (Deprecated)
      • List all agents
      • Create a new agent
      • Get an agent
      • Update an agent
      • Delete an agent
    • Schemas
      • Error
      • Pagination
      • UUID
      • Timestamp
      • SuccessResponse
      • STTConfig
      • LLMConfig
      • TTSConfig
      • Agent
      • XAIRealtimeConfig
      • AgentCreate
      • AgentUpdate
      • PhoneNumber
      • PhoneNumberCreate
      • PhoneNumberUpdate
      • Call
      • CallControlCommand
      • InjectContextCommand
      • SayCommand
      • EndCallCommand
      • TransferCommand
      • CallControlResponse
      • OutboundCallRequest
      • UsageLog
      • OutboundCallResponse
      • UsageSummary
      • Organization
      • SipTrunk
      • SipTrunkCreate
      • OrganizationChild
      • Voice
      • OrganizationCreate
      • OrganizationCreated
      • AssistantRequestPayload
      • CallObject
      • Customer
      • AssistantRequestResponse
      • XAIRealtimeVoice
      • AssistantConfigOverride
      • AnalysisPlan
      • AssistantWebhookObject
      • ToolCallsPayload
      • ToolCall
      • ToolCallsResponse
      • StatusUpdatePayload
      • EndOfCallReportPayload
      • ToolDefinition
      • EndCallTool
      • TransferCallTool
      • WebhookHeaders
      • XAIRealtimeWebhookNotes
      • ToolFunctionConfig
      • ToolTransferConfig
      • ToolTemplate
      • ToolTemplateCreate
      • ToolTemplateUpdate
      • AnalysisTemplate
      • CreateAnalysisTemplate
      • UpdateAnalysisTemplate
      • AnalysisTemplateListResponse
      • CampaignLead
      • Campaign
      • CampaignCreate
      • CampaignUpdate
      • CampaignLeadCreate
    DocumentationAPI Reference
    DocumentationAPI Reference
    Book a meeting
    Linkedin
    Github

    OutboundCallRequest

    Request to initiate an outbound call.
    Three modes are supported:
    1.
    Reference mode: Provide agent_id to use a saved agent
    2.
    Transient mode: Provide agent with full configuration
    3.
    Hybrid mode: Provide both agent_id and agent (agent fields override saved agent)
    You must provide either agent_id OR agent (or both for hybrid mode).

    {
        "destination": "+31612345678",
        "number_id": "7f8a9b2c-3d4e-5f6g-7h8i-9j0k1l2m3n4o",
        "assistant_id": "17a0cb75-fa09-4bdd-9a44-92a70d829c88",
        "assistant_override": {
            "first_message": "Hello John, how can I help you today?",
            "stt_config": {
                "provider": "deepgram",
                "model": "nova-3-general",
                "language": "multi",
                "keyterms": [
                    "yes",
                    "no",
                    "okay",
                    "Acme"
                ],
                "tag_audio_events": true,
                "include_timestamps": false,
                "sample_rate": 16000,
                "languages": [
                    "nl",
                    "en"
                ],
                "code_switching": true,
                "region": "eu-west",
                "endpointing": 0.05,
                "custom_vocabulary": [
                    "HMS Sovereign",
                    "Flireo"
                ],
                "translation_enabled": false,
                "translation_target_languages": [
                    "en"
                ]
            },
            "llm_config": {
                "provider": "openai",
                "model": "gpt-5-mini",
                "voice": "ara",
                "temperature": 0.7,
                "messages": [
                    {
                        "role": "system",
                        "content": "string"
                    }
                ],
                "tools": [
                    {
                        "name": "lookup_contact",
                        "description": "Look up contact information by name or phone number",
                        "url": "https://n8n.example.com/webhook/contacts",
                        "async": false,
                        "parameters": {
                            "type": "object",
                            "properties": {
                                "query": {
                                    "type": "string",
                                    "description": "Name or phone number to search"
                                }
                            },
                            "required": [
                                "query"
                            ]
                        }
                    }
                ]
            },
            "tts_config": {
                "provider": "elevenlabs",
                "voice_id": "alloy",
                "model": "eleven_flash_v2_5",
                "language": "nl",
                "stability": 0.5,
                "similarity_boost": 0.75,
                "use_speaker_boost": true,
                "speed": 1,
                "style": 0
            },
            "analysis_plan": {
                "structured_data_plan": {
                    "enabled": true,
                    "schema": {
                        "type": "object",
                        "properties": {
                            "intent": {
                                "type": "string"
                            },
                            "sentiment": {
                                "type": "string",
                                "enum": [
                                    "positive",
                                    "neutral",
                                    "negative"
                                ]
                            },
                            "appointment_booked": {
                                "type": "boolean"
                            }
                        }
                    },
                    "messages": [
                        {
                            "role": "system",
                            "content": "Analyze the following call transcript according to this schema: {{schema}}"
                        }
                    ]
                },
                "min_messages_threshold": 2
            },
            "voicemail_detection": false,
            "voicemail_message": "Hello, this is Acme Corp. We will call you back at a later time. Thank you!",
            "autonomous_silence_handling": false,
            "silence_timeout_seconds": 8,
            "gdpr_mode": false
        },
        "assistant": {},
        "agent_id": "17a0cb75-fa09-4bdd-9a44-92a70d829c88",
        "agent": {},
        "agent_config": {},
        "first_message": "Good afternoon, I'm calling on behalf of Acme to confirm your appointment.",
        "context": "Customer has appointment on 2025-12-15 at 14:00. Reminder call."
    }
    Built with