Lead Conversion Options
Purpose
To get the lead's conversion options before converting it to a Deal, Account or a Contact. This API fetches the matching records from Accounts, Contacts, and Deals. This allows you to map the data correctly and avoid any duplicity while converting a lead.
Request Details
Request URL
{api-domain}/crm/{version}/Leads/{record_id}/__conversion_options
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.modules.ALL
(or)
scope=ZohoCRM.modules.Leads.{operation_type}
Possible operation types
ALL - Full access to the record
READ - Get records from the module
Sample Request
Copied
Response JSON Keys
- module_preferenceJSON object
The API name and ID of the module that matches closest to the data in the lead.
- ContactsJSON Array
Represents the details of the contact that matches with the lead.
- preference_field_matched_valueJSON object
Represents the details such as the field and the value of the Contact and Account that matches with the lead.
- modules_with_multiple_layoutsJSON array
Represents the API name and ID of the module that matches with the lead and contains multiple layouts.
Possible Errors
- NO_CONTENTHTTP 204
No matching account or contact is found and no custom layout is present in account, contact and deal, or Accounts, Deals, or Contacts are removed from "Organize modules".
- INVALID_DATAHTTP 400
The given ID seems to be invalid.
Resolution: Specify a valid Lead ID. - NOT_APPROVEDHTTP 400
The record is not approved
Resolution: The lead record is under the approval process pending approval. - RECORD_LOCKEDHTTP 400
The record under merge is locked
Resolution: The record is under merge operation. Wait for the merge operation to complete.
Sample Response
Copied