---
title: "Convert Lead"
method: POST
path: "/api/v1/leads/{lead_id}/convert"
tags: ["leads"]
---

# Convert Lead

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

Convert a lead to Account + Contact + optional Opportunity.

## Path parameters

- `lead_id` integer, required

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- LeadConvertRequest
  - `account_id` integer, nullable
  - `account_name` string, nullable
  - `contact_id` integer, nullable
  - `create_opportunity` boolean
  - `opportunity_id` integer, nullable
  - `opportunity_name` string, nullable
  - `opportunity_stage` string

## Response `200`

Successful Response

- LeadConvertResponse
  - `lead_id` integer, required
  - `account_id` integer, required
  - `contact_id` integer, required
  - `opportunity_id` integer, nullable
  - `converted_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ninjavan/apis/salesforce-sales-cloud-replacement.md) · [All operations](https://skmtc.net/ninjavan/apis/salesforce-sales-cloud-replacement/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ninjavan/salesforce-sales-cloud-replacement/versions/fd3a41a6260b/schema)