Lead

Properties

PropertyTypeDescription
lead_idstringMust be a UUID. The unique identifier of the lead.
typestringThe lead's entity type, either individual or company.
idobject, nullnull is allowed. Object containing the lead's identification number, type and country.
date_of_birthstring, nullnull is allowed. The lead's date of birth.
genderstring, nullnull is allowed. The lead's gender (male or female).
first_namestringThe lead's legal first name.
middle_namestring, nullnull is allowed. The lead's legal middle name.
last_namestringThe lead's legal last name.
emailstring, nullnull is allowed. The lead's contact email address.
cellphonestring, nullnull is allowed. The lead's contact cellphone number.
phone_otherstring, nullnull is allowed. The lead's alternative phone number.
created_atstringThe time at which the lead was created.
updated_atstringThe time at which the lead was updated.
updated_byobjectAn object indicating the user or API key that updated the lead. See Authentication.
app_dataobject, nullnull is allowed. An object containing additional custom data for the lead.
created_byobjectAn object indicating the user or API key that created the lead. See Authentication.
addressobject, nullnull is allowed. The lead's physical address. See below for more details.

Example

{
  "lead_id": "bf1ada91-eecb-4f47-9bfa-1258bb1e0055",
  "type": "individual",
  "first_name": "Erlich",
  "middle_name": "Aviato",
  "last_name": "Bachman",
  "id": {
    "type": "id",
    "number": "6801015800084",
    "country": "ZA"
  },
  "date_of_birth": "1968-01-01",
  "gender": "male",
  "email": "[email protected]",
  "cellphone": null,
  "phone_other": null,
  "created_at": "2017-10-12T15:47:34.281Z",
  "app_data": {
    "company": "Aviato"
  },
  "created_by": {
    "id": "00000000-0000-0000-0000-000000000001",
    "type": "user"
  },
  "address": {
    "line_1": "5230 Penfield Avenue",
    "suburb": "Woodland Hills",
    "city": "Los Angeles",
    "country": "US",
    "area_code": "CA 91364"
  }
}