Skip to main content
POST
https://api.tuner.ai
/
v1
/
calls
Send Call Data
curl --request POST \
  --url https://api.tuner.ai/v1/calls \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "<string>",
  "callId": "<string>",
  "transcript": [
    {
      "transcript[].role": "<string>",
      "transcript[].content": "<string>",
      "transcript[].timestamp": "<string>"
    }
  ],
  "startedAt": "<string>",
  "endedAt": "<string>",
  "metadata": {
    "metadata.durationSeconds": 123,
    "metadata.callDirection": "<string>",
    "metadata.callerPhone": "<string>",
    "metadata.outcome": "<string>"
  }
}
'
{
  "success": true,
  "callId": "call_12345",
  "tunerCallId": "tc_abc123def456",
  "message": "Call data received successfully."
}

curl --request POST \
  --url https://api.tuner.ai/v1/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "agent_abc123",
  "callId": "call_12345",
  "transcript": [
    {
      "role": "agent",
      "content": "Hello, thank you for calling. How can I help you today?"
    },
    {
      "role": "user",
      "content": "I would like to schedule an appointment."
    }
  ],
  "startedAt": "2026-01-17T10:00:00Z",
  "endedAt": "2026-01-17T10:02:00Z",
  "metadata": {
    "durationSeconds": 120,
    "callDirection": "inbound",
    "callerPhone": "+1234567890"
  }
}
'

{
  "success": true,
  "callId": "call_12345",
  "tunerCallId": "tc_abc123def456",
  "message": "Call data received successfully."
}

​
Authorizations

​
Authorization
string
required
API key in Bearer token format

​
Body

​
agentId
string
required
ID of the agent in Tuner that this call belongs toExample: "agent_abc123"
​
callId
string
required
A unique identifier for this call from your systemExample: "call_12345"
​
transcript
object[]
required
Array of messages in the conversation
​
startedAt
string
ISO 8601 timestamp of when the call startedExample: "2026-01-17T10:00:00Z"
​
endedAt
string
ISO 8601 timestamp of when the call endedExample: "2026-01-17T10:02:00Z"
​
metadata
object
Additional metadata about the call

​
Response

​
success
boolean
Whether the request was successful
​
callId
string
The call ID you provided in the requestExample: "call_12345"
​
tunerCallId
string
Tuner’s internal ID for this call. Use this to reference the call in the dashboard.Example: "tc_abc123def456"
​
message
string
A human-readable status messageExample: "Call data received successfully."