---
title: "POST recordingCompleted"
method: POST
path: "recordingCompleted"
---

# POST recordingCompleted

`POST recordingCompleted` (webhook)

The `recording.completed` event is delivered whenever a call recording has been processed and is ready for playback. This event is not triggered for voicemail recordings.

## Payload

- RecordingCompletedEvent
  - `account_id` string, required — The ID of the account in which this event occurred
  - `data` object, required — The data associated with the event
    - `call` object, required — The call that produced this recording
      - `contact` Contact, required — A contact who has consented to receive messages
        - `email` string, email — The contact's email address.
        - `first_name` string — The contact's first name.
        - `id` string, required — Unique identifier for the object.
        - `last_name` string — The contact's last name.
        - `metadata` Metadata — Set of key-value pairs that will be stored with the object.
        - `phone_number` string, phone-number, required — The contact's phone number in E.164 format.
      - `duration` integer, required — The duration of the call in seconds
      - `from` string, nullable — The E.164 phone number of the caller
      - `id` string, required — The unique identifier for the call
      - `initiated_at` string, date-time, required — When the call was initiated
      - `phone_number_id` string, nullable — The Surge phone number ID (e.g. pn_...)
      - `status` 'busy' | 'canceled' | 'completed' | 'failed' | 'in_progress' | 'missed' | 'no_answer' | 'queued' | 'ringing', required — The status of the call
      - `to` string, nullable — The E.164 phone number of the callee
    - `duration` integer, required — The duration of the recording in seconds
    - `id` string, required — The unique identifier for the recording
  - `timestamp` string, date-time, required — The timestamp when this event occurred, in ISO8601 format
  - `type` 'recording.completed', required — The type of the event. Always `recording.completed` for this event.

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

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