---
title: "Promote Deal To Client For User"
method: POST
path: "/api/prospecting/deals/{deal_id}/promote-to-client"
tags: ["prospecting"]
---

# Promote Deal To Client For User

`POST /api/prospecting/deals/{deal_id}/promote-to-client`

## Request

- Base URL: `https://api.every.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.every.ai/api/prospecting/deals/{deal_id}/promote-to-client`
- Auth: none declared

Resolve a client for a deal from an explicit user choice.

## Query parameters

- `user_id` string, nullable
- `org_id` string, nullable

## Request body

- PromoteToClientRequest
  - `mode` 'link_existing' | 'create_new' | 'link_person', required
  - `client_id` string, nullable
  - `contact_id` string, nullable
  - `name` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `auto_enrich` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-10** `fa3b495a731d`: 3 info
  - added the new optional request property `auto_enrich`
  - added the new optional request property `contact_id`
  - added the new `link_person` enum value to the request property `mode`

[Operation history](https://skmtc.dev/every/apis/every-api/changes/api/prospecting/deals/:deal_id/promote-to-client/post.md)

---

[API](https://skmtc.dev/every/apis/every-api.md) · [All operations](https://skmtc.dev/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc.dev/every/apis/every-api/revisions/8b1e740c73b8?raw)