Back to overview

Standard lead parameters

Last updated on June 26, 2025

Param Type Required Description
lead_type_id INT X Leadnodes Lead Type ID
company STRING Company name of the new lead
gender STRING m = male , f = female
first_name STRING First Name from the new lead
last_name STRING Last Name from the new lead
fullname STRING First and last name combination separated by the first space
birth_date DATE Birth date from the new lead
street_no STRING Street and building number from the new lead
zip_code STRING Zip code from the new lead
city STRING City from the new lead
country_code STRING ISO 3166 Country Code (alpha-2 e.g. DE, AT, CH etc.)
phone STRING Phone number from the new lead
email STRING Email-Address from the new lead
custom_data ARRAY Custom lead data fields from the lead type
ip STRING IP Address
uuid_required BOOL Specifies whether a UUID should be present when submitting.
uuid STRING Universally Unique Identifier
campaignid STRING Campaign ID for reporting on groups of campaigns
creative STRING Advertising media (e.g. Banner, Link etc.)
device STRING Device m = mobile , t = tablet, d = desktop
keyword STRING Keyword
matchtype STRING e = exact match, b = broad match, p = phrase match
placement STRING Site, app, newsletter of the advertising placement
newsletter_optin BOOL Determines whether the lead has agreed to a newsletter.
affili_id INT User ID from the Affiliate User

Example lead object

{
"lead_type_id" : "1",
"gender" : "m",
//"fullname" : "John Doe", will be separated
"first_name" : "John",
"last_name" : "Doe",
"birth_date" : "1982-10-02",
"street_no" : "Nieder-Kinziger-Str. 27b",
"zip_code" : "64732",
"city" : "Frankfurt",
"phone" : "+49465465466",
"email" : "email@lead.com",
"custom_data" : { "custom_lead_type_field" : "value", },
"ip" : "192.186.105.13",
"uuid" : "ID1234678XYZ",
"campaignid" : "12345",
"creative" : "ad name",
"device" : "m",
"keyword" : "keyword",
"matchtype" : "e",
"placement" : "google.com",
"newsletter_optin" : "0"
}