Skip to main content
PUT
Save Outbound Config

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

agent_id
string
required

Tuner's numeric agent ID, or your Agent ID from Agent Settings > Agent Connection. Digits-only values are read as the numeric ID.

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Body

application/json
trigger_url
string | null

URL Tuner sends a POST request to in order to start an outbound call, up to 2048 characters. Required for a custom webhook; must be omitted when phone_number_id is set.

headers
OutboundConfigHeader · object[] | null

Extra HTTP headers to send with the request to trigger_url.

body_template_json
string | null

JSON body to send to trigger_url. Placeholders in double curly braces are filled in at call time, and it must contain {{sipUriToDial}}. Required for a custom webhook; must be omitted when phone_number_id is set.

phone_number_id
string | null

ID of the phone number to place calls from, on the agent's own provider (Vapi or ElevenLabs). For ElevenLabs it must be a SIP trunk number whose outbound trunk address points at Tuner's SIP route. Set this instead of trigger_url and body_template_json to let Tuner place the call through the provider.

Minimum string length: 1
vapi_phone_number_id
string | null
deprecated

Deprecated, use phone_number_id. Accepted for one more release as an alias; if both are sent they must be equal.

Minimum string length: 1

Response

Successful Response

id
integer
required

Outbound configuration ID.

agent_settings_id
integer
required

ID of the agent settings the configuration belongs to.

trigger_url
string | null
required

URL Tuner sends a POST request to in order to start an outbound call.

headers
OutboundConfigHeader · object[] | null
required

Extra HTTP headers sent with the request to trigger_url.

body_template_json
string | null
required

JSON body template sent to trigger_url.

phone_number_id
string | null
required

ID of the phone number calls are placed from, on the agent's own provider (Vapi or ElevenLabs). Null for a custom webhook.

vapi_phone_number_id
string | null
required
deprecated

Deprecated, use phone_number_id. Same value as phone_number_id for Vapi agents, null otherwise. Kept for one more release.

created_at
string<date-time>
required

When the configuration was created.

updated_at
string<date-time>
required

When the configuration was last updated.