Convert Lead

View as Markdown
Convert a qualified Lead → Customer (+ optional first Opportunity) per PRD §9.1. **Body shape:** - `customer[*]` — optional overrides for derived customer fields (loose passthrough; deep validation in CustomerService). - `opportunity[*]` — optional first-opportunity payload; mirrors Opportunity create fields, all optional.

Headers

{{tenant_key_name}}stringOptional

Request

This endpoint expects a multipart form.
customer[email]stringRequired

Optional: override derived primary email

customer[phone]stringRequired

Optional: override derived primary phone

opportunity[name]stringRequired

Optional: opportunity name. If omitted, no opportunity is created.

customer[last_name]stringRequired

Optional: override derived last name

customer[first_name]stringRequired

Optional: override derived first name

opportunity[description]stringRequired

Optional: opportunity description

opportunity[expected_value]stringRequired

Optional: numeric >= 0

Response

Successful response