- List calls
- Log calls (create call records)
- Get call dispositions
- Retrieve call recordings
-
Logging a call via
POST /calls
after it’s completed (to record calls made outside Amplemarket) - Optionally setting a disposition to categorize the call outcome
-
Retrieving call recordings via
GET /calls/{id}/recording
for analysis or compliance purposes
Calls can be logged with various metadata including duration, transcription, recording URLs, and dispositions to help track and analyze your outreach efforts.
Call Object
Field | Type | Description |
---|---|---|
id | string (uuid) | The ID of the call |
from | string | The phone number that initiated the call |
to | string | The phone number that received the call |
duration | integer | The duration of the call in seconds |
answered | boolean | Whether the call was answered |
human | boolean | Whether a human answered the call or if it was detected as a machine/voicemail |
transcription | string or null | The text representation of the call’s audio, if available |
notes | string or null | Custom notes associated with the call |
recording_url | string | URL to the call recording (if available) |
disposition_id | string (uuid) | Call disposition ID. The disposition action determines behavior: “complete” marks the task and lead as completed, while “next_stage” takes no action purposefully - read more below |
task_id | string (uuid) | The ID of the task associated with this call |
user_id | string (uuid) | The ID of the user who made the call |
external | boolean | Whether the call was made externally (outside of Amplemarket) |
start_date | string (date-time) | The start date and time of the call in ISO 8601 format |
Example Call Object
Logging Calls
To log a call, send aPOST
request to /calls
with the following required fields:
from
(string, required) - The phone number that initiated the callto
(string, required) - The phone number that received the callduration
(integer, required) - The duration of the call in secondsanswered
(boolean, required) - Whether the call was answeredhuman
(boolean, required) - Whether a human answered or if it was a machine/voicemailtask_id
(string uuid, required) - The ID of the task associated with the calluser_id
(string uuid, required) - The ID of the user making the call
transcription
(string) - The text transcription of the callrecording_url
(string) - URL to the call recordingdisposition_id
(string uuid) - Call disposition ID to categorize the outcome
Example Request
Call Dispositions
When logging a call, you can optionally include adisposition_id
to categorize the outcome and trigger the appropriate action.
Call dispositions allow you to categorize the outcome of calls. You can retrieve available dispositions using the GET /calls/dispositions
endpoint.
Dispositions have different actions that determine how the system responds:
-
next_stage
- No automatic action is taken. This allows your integration to repeat the call or schedule another attempt if needed. The task and lead remain in their current state. You can manually complete the task when ready. -
complete
- The associated task and sequence lead will automatically be marked as completed. Use this when the call objective has been achieved and no further attempts are needed.