POST /crm/v4/Leads/{lead_id}/actions/convert

Convert a maximum of up to 50 leads in a single API call. You can convert a lead with or without creating a deal through this API.

Servers

Path parameters

Name Type Required Description
lead_id String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
data[] Array No
data[].notify_new_entity_owner Boolean No
data[].Deals Object No
data[].Deals.Amount Number No
data[].Deals.Stage String No
data[].Deals.Deal_Name String No
data[].Deals.Pipeline String No
data[].Deals.Closing_Date String No
data[].carry_over_tags Object No
data[].carry_over_tags.Deals[] Array No
data[].carry_over_tags.Accounts[] Array No
data[].carry_over_tags.Contacts[] Array No
data[].Accounts Object No
data[].Accounts.id String No
data[].overwrite Boolean No
data[].notify_lead_owner Boolean No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.