Skip to main content
POST
/
v1
/
leads
Create lead API
curl --request POST \
  --url https://api.example.com/v1/leads
{
  "data": {
    "id": 44,
    "status": "submitted",
    "created_at": "2025-05-16",
    "lead_info": {
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "converted_to": null,
    "submitter": {
      "id": "partner_123",
      "name": "John Doe",
      "email": "[email protected]"
    },
    "submission_form": [
      {
        "question": "Name",
        "answer": "Alice Brown"
      },
      {
        "question": "Email address",
        "answer": "[email protected]"
      },
      {
        "question": "Company",
        "answer": "Acme Inc"
      },
      {
        "question": "Notes",
        "answer": "Looking for enterprise plan"
      }
    ],
    "can_be_converted": true,
    "can_be_rejected": true
  },
  "status": 1
}

​
Endpoint

POST https://api.partnero.com/v1/leads

​
Request Body

ParameterTypeRequiredDescription
namestringYesLead’s full name
emailstringYesLead’s email address
partnerobjectYesPartner attribution data
partner.keystringNoPartner’s referral key
partner.idstringNoPartner’s ID (alternative to key)
partner.emailstringNoPartner’s email (alternative to key)
cfieldsobjectNoCustom form field values. Keys are field IDs from lead form config.

​
Request

cURL
curl --location 'https://api.partnero.com/v1/leads' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Alice Brown",
    "email": "[email protected]",
    "partner": {
      "key": "ref_123"
    },
    "cfields": {
      "89": "Acme Inc",
      "90": "Looking for enterprise plan",
      "91": ["feature1", "feature3"],
      "94": "US"
    }
  }'

​
Response

{
  "data": {
    "id": 44,
    "status": "submitted",
    "created_at": "2025-05-16",
    "lead_info": {
      "name": "Alice Brown",
      "email": "[email protected]"
    },
    "converted_to": null,
    "submitter": {
      "id": "partner_123",
      "name": "John Doe",
      "email": "[email protected]"
    },
    "submission_form": [
      {
        "question": "Name",
        "answer": "Alice Brown"
      },
      {
        "question": "Email address",
        "answer": "[email protected]"
      },
      {
        "question": "Company",
        "answer": "Acme Inc"
      },
      {
        "question": "Notes",
        "answer": "Looking for enterprise plan"
      }
    ],
    "can_be_converted": true,
    "can_be_rejected": true
  },
  "status": 1
}
Get the custom field IDs from the GET /v1/leads/details endpoint to properly map form fields.