Skip to main content
GET
/
v1
/
leads
/
convert
Convert lead
curl --request GET \
  --url https://api.example.com/v1/leads/convert
{
  "data": {
    "id": 44,
    "status": "converted",
    "created_at": "2025-05-16",
    "lead_info": {
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "converted_to": {
      "key": "NSpBI1qWSE4J",
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "submitter": {
      "id": "partner_123",
      "name": "John Doe",
      "email": "[email protected]"
    },
    "submission_form": [
      {
        "question": "Name",
        "answer": "Alice Brown"
      },
      {
        "question": "Email address",
        "answer": "[email protected]"
      }
    ],
    "can_be_converted": false,
    "can_be_rejected": false
  },
  "status": 1
}

​
Endpoint

GET https://api.partnero.com/v1/leads/convert

​
Query Parameters

ParameterTypeRequiredDescription
idintegerYesLead ID to convert
commission_transaction_amountnumberYesTransaction amount for commission calculation

​
Request

cURL
curl --location 'https://api.partnero.com/v1/leads/convert?id=44&commission_transaction_amount=500' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Response

{
  "data": {
    "id": 44,
    "status": "converted",
    "created_at": "2025-05-16",
    "lead_info": {
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "converted_to": {
      "key": "NSpBI1qWSE4J",
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "submitter": {
      "id": "partner_123",
      "name": "John Doe",
      "email": "[email protected]"
    },
    "submission_form": [
      {
        "question": "Name",
        "answer": "Alice Brown"
      },
      {
        "question": "Email address",
        "answer": "[email protected]"
      }
    ],
    "can_be_converted": false,
    "can_be_rejected": false
  },
  "status": 1
}

​
Response Fields

FieldTypeDescription
data.converted_toobjectThe created customer
data.converted_to.keystringNew customer’s unique key
data.converted_to.namestringCustomer name
data.converted_to.emailstringCustomer email
After conversion, the lead’s status changes to converted and can_be_converted becomes false.

​
Reject a Lead

To reject a lead instead of converting: 
GET https://api.partnero.com/v1/leads/reject?id=44
ParameterTypeRequiredDescription
idintegerYesLead ID to reject
This marks the lead as rejected without creating a customer.