---
title: "Mark a call recording as ready for retrieval."
method: POST
path: "/crm/extensions/calling/2026-09/recordings/ready"
tags: ["Advanced"]
---

# Mark a call recording as ready for retrieval.

`POST /crm/extensions/calling/2026-09/recordings/ready`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/extensions/calling/2026-09/recordings/ready`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.schemas.contacts.write`

This endpoint is used to mark a call recording as ready. It requires the engagementId to identify the specific recording.

## Request body

- MarkRecordingAsReadyRequest
  - `engagementId` integer, required: The unique identifier for the engagement associated with the call recording.

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `8bccef69948c`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.schemas.contacts.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-10** (2026-09) `35046bde1057`: 9 info
  - the endpoint scheme security `private_apps` was removed from the API
  - the endpoint scheme security `private_apps` was removed from the API
  - the endpoint scheme security `private_apps` was removed from the API
  - the endpoint scheme security `private_apps` was removed from the API
  - …5 more

[Operation history](https://skmtc.dev/hubspot/apis/crm-calling-extensions/changes/crm/extensions/calling/2026-09/recordings/ready/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-calling-extensions.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-calling-extensions/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-calling-extensions/revisions/8bccef69948c?raw)