POST
/
calls
curl --request POST \
  --url https://api.amplemarket.com/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.amp+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": "019584f8-1d70-7936-993e-ead213918706",
  "disposition_id": "019584f8-1c5f-72a9-8253-00da37e0cb3e",
  "duration": 5,
  "from": "+1 123456789",
  "to": "+1 123456789",
  "notes": null,
  "transcription": null,
  "task_id": "019584f8-1d1a-78a0-8765-122c71ba7cdb",
  "user_id": "019584f8-1cb6-7440-a312-f3967eb6231a",
  "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/vnd.amp+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
required
​
user_id
string
required
​
transcription
string

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

​
recording_url
string
​
disposition_id
string

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

201
application/vnd.amp+json
successful
​
id
string
​
disposition_id
string
​
duration
integer | null
​
form
string | null
​
to
string | null
​
notes
string | null
​
transcription
string | null
​
task_id
string
​
user_id
string
​
answered
boolean
​
human
boolean

Was this page helpful?