---
title: "Log call"
method: POST
path: "/calls"
tags: ["Calls"]
---

# Log call

`POST /calls`

Log call

## Request body

- object
  - `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
  - `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.
  - `task_id` string, uuid, required
  - `user_id` string, uuid, required

## Response `201`

successful

- object
  - `id` string, uuid
  - `disposition_id` string, uuid
  - `duration` integer
  - `from` string
  - `to` string
  - `notes` string, nullable
  - `transcription` string, nullable
  - `task_id` string, uuid
  - `user_id` string, uuid
  - `answered` boolean
  - `human` boolean
  - `external` boolean
  - `start_date` string, date_time
  - `contact` object, nullable
    - `id` string
    - `name` string, nullable
    - `email` string, nullable

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs.md) · [All operations](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amplemarket/amplemarket-api-v1-docs/revisions/57f46eaa2dc9/schema)