---
title: "Convert a held email into a new client request"
method: POST
path: "/firm/client-requests/inbound-holds/{id}/convert"
tags: ["Client Requests (Firm)"]
---

# Convert a held email into a new client request

`POST /firm/client-requests/inbound-holds/{id}/convert`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/firm/client-requests/inbound-holds/{id}/convert`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `companyOrganizationId` string, uuid, required: Firm-managed company the new request belongs to.
  - `subject` string, nullable
  - `ownerIds` string[]
  - `reason` string, nullable

## Response `200`

Updated hold and the created request

- object
  - `hold` object: Held inbound email awaiting firm review before it can enter a client-request thread.
    - `id` string, uuid
    - `firmOrganizationId` string, uuid
    - `organizationId` string, uuid, nullable
    - `requestId` string, uuid, nullable
    - `state` 'held' | 'attached' | 'converted' | 'dismissed'
    - `holdReason` string
    - `senderEmail` string
    - `subject` string, nullable
    - `bodyText` string, nullable
    - `decisionReason` string, nullable
    - `decidedAt` string, date-time, nullable
    - `emailReceivedAt` string, date-time, nullable
    - `createdAt` string, date-time
  - `request` object

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)