• List calls
• Log calls (create call records)
• Get call dispositions
• Retrieve call recordings

1. Logging a call via POST /calls after it’s completed (to record calls made outside Amplemarket)
2. Optionally setting a disposition to categorize the call outcome
3. Retrieving call recordings via GET /calls/{id}/recording for analysis or compliance purposes

​

Call Object

​

Contact Object

​

Example Call Object

{
  "id": "0199ba5b-e387-7d61-8ae4-6ad9ce65f07b",
  "disposition_id": "0199ba5b-e20c-7dc1-9481-097d1256e75b",
  "duration": 5,
  "external": true,
  "start_date": "2025-10-06T16:30:08Z",
  "from": "+1 123456789",
  "to": "+1 123456789",
  "notes": null,
  "transcription": null,
  "task_id": "0199ba5b-e332-77e3-8f73-b86f921ad681",
  "user_id": "0199ba5b-e2fd-764a-9f21-5df8758d5dd3",
  "human": false,
  "answered": true,
  "contact": {
    "id": "0199ba5b-e123-7abc-8def-123456789012",
    "name": "John Doe",
    "email": "john.doe@example.com"
  }
}

​

Logging Calls

• 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) - Whether the call was answered
• human (boolean, required) - Whether a human answered or if it was a machine/voicemail
• task_id (string uuid, required) - The ID of the task associated with the call
• user_id (string uuid, required) - The ID of the user making the call

• transcription (string) - The text transcription of the call
• recording_url (string) - URL to the call recording
• disposition_id (string uuid) - Call disposition ID to categorize the outcome

​

Example Request

curl --request POST \
  --url https://api.amplemarket.com/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "from": "+1 123456789",
  "to": "+1 987654321",
  "duration": 120,
  "answered": true,
  "human": true,
  "transcription": "Call transcription here...",
  "recording_url": "https://example.com/recording.mp3",
  "disposition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'

​

Call Dispositions

• 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.

​

Call Recordings