Mass Convert Lead Status

Purpose

To get the status of the mass convert lead job scheduled previously.

Endpoints

Request Details

Request URL

{api-domain}/Leads/actions/mass_convert?job_id={job_id}

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.mass_convert.leads.READ

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v4/Leads/actions/mass_convert?job_id= 3652397000009835020"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Response JSON Keys

  • Statusstring

    Indicates the status of the mass convert lead API. Possible values are "completed", "scheduled", and "in progress", and "failed".

  • Total_Countinteger

    Specifies the total number of leads that were scheduled to be converted.

  • Converted_Countinteger

    Specifies the number of leads that were converted.

  • Not_Converted_Countinteger

    Specifies the number of leads that are yet to be converted.

  • Failed_Countinteger

    Specifies the number of leads that were not converted.

Possible Errors

  • REQUIRED_PARAM_MISSINGHTTP 400

    You have not specified the job_id in the request.
    Resolution: The specified job_id is not found or invalid. Specify a valid job_id.

  • INVALID_DATAHTTP 400

    The job_id is invalid.
    Resolution: Specify a valid job ID.

Sample Response

Copied{
    "data": [
        {
            "Status": "COMPLETED",
            "Failed_Count": 0,
            "Not_Converted_Count": 0,
            "Total_Count": 28,
            "Converted_Count": 28
        }
    ]
}