---
title: "Convert Lead To Company"
method: POST
path: "/api/sales/leads/{lead_id}/convert"
tags: ["Sales"]
---

# Convert Lead To Company

`POST /api/sales/leads/{lead_id}/convert`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/sales/leads/{lead_id}/convert`
- Auth: HTTP bearer

Convert a lead into a client company — the moment the deal verbally
closes (Epic 1.2).

Reuses the existing POST /api/companies creation chain verbatim (all
7 onboarding steps fire: Stripe, portal user, MSA via BoldSign, Slack
channel, credentials email, first project). On top of it:

  1. Links company.lead_id (channel attribution).
  2. Closes the lead as won (same semantics as /close).
  3. Resolves any open intro-request SLA timers.

Hard guards (the whole point of the button): refuses to run without a
signer, without a BoldSign key, or into an existing domain — and
reports `msa_sent` honestly so a BoldSign API failure is a red error
in the dialog, not a log line.

## Path parameters

- `lead_id` string, required

## Request body

- LeadConvertRequest: One-click convert: pre-filled from the lead row, corrected in the dialog. Signer fields are REQUIRED here even though CompanyCreate allows them empty — inside the convert flow a missing signer means the MSA silently never goes out (auto_send_msa no-ops), which is the silent-failure class this epic exists to kill.
  - `company_name` string, required
  - `domain` string, required
  - `signer_name` string, required
  - `signer_email` string, email, required
  - `billing_email` string, email, nullable
  - `pricing_tier` string, nullable
  - `service_type` string, nullable
  - `deal_value` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)