Leads

📄️ Create Lead

Creates a new lead. A lead is a customer with a lead-information record; only a name is required. Addresses are added later via the lead addresses sub-resource.

📄️ Get Lead

Retrieves a single lead (customer plus lead-information fields) by its ID.

📄️ Update Lead

Replaces the editable lead fields. When Name is supplied, the lead's name/contact details on the underlying customer are updated too.

Converts a lead into a customer: completes the customer's contact/billing fields (identity, name, billing email, bill profile, custom fields, status, and preventAutoClose) and backfills any placeholder addresses from the lead's completed address. Status and preventAutoClose keep the customer's current values when omitted (a customer that is already closed stays closed); Closed is never accepted as an explicit status. Type, account number, and parent are preserved (client-supplied values for those are ignored). The API does not support reversing a conversion.