---
title: "Convert To Lead"
method: POST
path: "/api/portal-messages/{message_id}/convert-to-lead"
tags: ["Portal Messages"]
---

# Convert To Lead

`POST /api/portal-messages/{message_id}/convert-to-lead`

Create a lead from a captured portal message (buyer data entered by the
user — the portal email has none). Reuses the normal lead pipeline; the lead
inherits the message's team and keeps the chat URL. Idempotent: a message
already converted returns its existing lead instead of creating another.

## Path parameters

- `message_id` integer, required

## Headers

- `x-api-token` string, nullable

## Request body

- ConvertLeadBody
  - `name` string, required
  - `email` string, nullable
  - `phone` string, nullable
  - `assign_to_self` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/1a3bc16bb0c0/schema)