Convert lead

Convert a lead to a customer

GET /v1/leads/convert

Convert lead

cURL

curl --request GET \
  --url https://api.example.com/v1/leads/convert

200 OK

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

Endpoint

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

Query Parameters

Parameter	Type	Required	Description
id	integer	Yes	Lead ID to convert
commission_transaction_amount	number	Yes	Transaction 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

200 OK

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

Response Fields

Field	Type	Description
data.converted_to	object	The created customer
data.converted_to.key	string	New customer’s unique key
data.converted_to.name	string	Customer name
data.converted_to.email	string	Customer 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

Parameter	Type	Required	Description
id	integer	Yes	Lead ID to reject

This marks the lead as rejected without creating a customer.