POST
/
calls
Log call
curl --request POST \
  --url https://api.amplemarket.com/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "from": "<string>",
  "to": "<string>",
  "duration": 123,
  "answered": true,
  "human": true,
  "transcription": "<string>",
  "recording_url": "<string>",
  "disposition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "id": "0198f652-76db-7505-8923-201bf75736eb",
  "disposition_id": "0198f652-7474-7991-b011-ba677639a2ab",
  "duration": 5,
  "external": true,
  "start_date": "2025-08-29T14:54:16Z",
  "from": "+1 123456789",
  "to": "+1 123456789",
  "notes": null,
  "transcription": null,
  "task_id": "0198f652-7662-757e-b819-cc8f5eccebcd",
  "user_id": "0198f652-760d-7dda-973f-eee1c80d3ec9",
  "human": false,
  "answered": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
from
string
required

The phone number that initiated the call

​
to
string
required

The phone number that received the call

​
duration
integer
required

The duration of the call in seconds

​
answered
boolean
required

A boolean indicating whether the call was answered

​
human
boolean
required

A boolean indicating whether a human answered the call or if it was detected as a machine/voicemail

​
task_id
string<uuid>
required
​
user_id
string<uuid>
required
​
transcription
string

The text representation of the call's audio, if available

​
recording_url
string
​
disposition_id
string<uuid>

Call disposition ID. If the given disposition has its action set to "complete", the specified task will be marked as completed, along with the associated sequence lead.

Response

successful

​
id
string<uuid>
​
disposition_id
string<uuid>
​
duration
integer
​
from
string
​
to
string
​
notes
string | null
​
transcription
string | null
​
task_id
string<uuid>
​
user_id
string<uuid>
​
answered
boolean
​
human
boolean
​
external
boolean
​
start_date
string<date_time>