---
title: "Log an external Call activity"
method: POST
path: "/activity/call/"
tags: ["activities.calls"]
---

# Log an external Call activity

`POST /activity/call/`

Use this endpoint to log calls made outside of the Close built-in VoIP system.

*status*: defaults to `completed`

*direction* (optional): `outbound` or `inbound`

*recording_url*: you can post a URL pointing to the MP3 recording of your call. For security reasons, we require the URL to be secure (i.e. starting with https://)

## Request body

- CreateCallActivity
  - `activity_at` string, date-time, nullable
  - `contact_id` string, nullable
  - `conversation_type_id` string, nullable
  - `created_by` string, nullable
  - `date_created` string, date-time, nullable
  - `direction` 'inbound' | 'outbound' | 'null', nullable
  - `duration` integer, nullable
  - `lead_id` string, nullable
  - `note` string, nullable
  - `note_html` string, nullable
  - `organization_id` string, nullable
  - `outcome_id` string, nullable
  - `phone` string, nullable — Phone number in E.164 format
  - `playbook_id` string, nullable
  - `quality_info` string, nullable
  - `recording_url` string, uri, nullable
  - `source` 'Close.io' | 'External' | 'null', nullable
  - `status` 'created' | 'in-progress' | 'completed' | 'cancel' | 'no-answer' | 'busy' | 'failed' | 'timeout' | 'null', nullable
  - `user_id` string, nullable
  - `voicemail_url` string, uri, nullable

## Response `200`

Successful response

- CallActivity
  - `_type` string, required
  - `activity_at` string, date-time, nullable, required
  - `contact_id` string, nullable, required
  - `created_by` string, nullable, required
  - `created_by_name` string, nullable
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `id` string, required
  - `lead_id` string, nullable, required
  - `organization_id` string, required
  - `outcome_id` string, nullable, required
  - `sequence_id` string, nullable
  - `sequence_name` string, nullable
  - `sequence_subscription_id` string, nullable
  - `source` 'Close.io' | 'External', required — Source of a phone activity. Describes whether the phone activity (such as a call or an SMS) was handled by Close's telephony provider or handled externally by a 3rd party and is merely logged in Close.
  - `status` 'created' | 'in-progress' | 'completed' | 'cancel' | 'no-answer' | 'busy' | 'failed' | 'timeout', required — Current status of the call.
  - `updated_by` string, nullable, required
  - `updated_by_name` string, nullable
  - `user_id` string, nullable, required
  - `user_name` string, nullable
  - `users` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)