Lead Data Models

Represents a lead

Model IDEvent Data KeyDescription
crm_lead_infoinfo
crm_lead_addressesaddresses
crm_lead_phonesphones
crm_lead_emailsemails
crm_lead_conversionconversion
crm_lead_custom_fieldscustomFields
User Mapped FieldsuserMappedFieldsField Mappings done via Mapping Presets

Lead Info

Model ID: crm_lead_info

NameTypeDescription
idString
firstNameString
lastNameString
companyString
descriptionString
industryString
jobTitleString
ownerUserPlease refer to https://developers.getknit.dev/reference/base-models#user
createdByUserPlease refer to https://developers.getknit.dev/reference/base-models#user
annualRevenueString
numberOfEmployeesDouble
statusString
websiteString
updatedAtDate
createdAtDate
lastActivityAtDate

Lead Addresses

Model ID: crm_lead_addresses

NameTypeDescription
addressesList[Address]Please refer to https://developers.getknit.dev/reference/base-models#address

Lead Phones

Model ID: crm_lead_phones

NameTypeDescription
phonesList[Phone]Please refer to https://developers.getknit.dev/reference/base-models#phone

Lead Emails

Model ID: crm_lead_emails

NameTypeDescription
emailsList[Email]Please refer to https://developers.getknit.dev/reference/base-models#email

Lead Conversion

Model ID: crm_lead_conversion

NameTypeDescription
convertedAtDate
convertedAccountIdString
convertedContactIdString
convertedDealIdString

Custom Fields

Model ID: crm_lead_custom_fields

All the custom/auto populated/calculated fields in the source CRM.

NameTypeDescription
fieldsMap<String, Object>

❗️

If you're only interested in a subset of fields rather than all the fields, consider mapping the fields you want using Mapping Presets. Custom Fields often include large number of CRM calculated and auto updated fields which might lead to a huge volume in delta_syncs

User Mapped Fields

Edit Field Mappings from the Knit dashboard for each integrated account to get unmapped fields. Read more about it here: https://developers.getknit.dev/docs/get-custom-fields-sync

NameTypeDescription
fieldsMap<String, Object>

Event Data Example

{
    "info": {
      "id": "35114635700",
      "firstName": "David",
      "lastName": "Matson",
      "company": "GoJo",
      "description": "Upcoming new media company",
      "industry": "Media",
      "jobTitle": "CEO",
      "owner": {
        "id": "407425865",
        "email": "[email protected]"
      },
      "createdBy": {
        "id": "407425865",
        "email": "[email protected]"
      },
      "annualRevenue": "1000000",
      "numberOfEmployees": 200.0,
      "status": "New",
      "website": "gojo.com",
      "updatedAt": "2023-05-23T12:04:28Z",
      "createdAt": "2023-05-23T12:04:28Z",
      "lastActivityAt": "2023-05-23T12:04:28Z"
    },
    "addresses": [
      {
        "addressLine1": "125, 32nd Street",
        "addressLine2": "9th Avenue",
        "city": "New York City",
        "state": "New York",
        "country": "United States of America",
        "zipCode": "54AZ",
        "addressType": "NOT_SPECIFIED"
      }
    ],
    "phones": [
      {
        "type": "NOT_SPECIFIED",
        "phoneNumber": "45684332463"
      }
    ],
    "emails": [
      {
        "type": "NOT_SPECIFIED",
        "email": "[email protected]"
      }
    ],
    "conversion": {
      "convertedAt": "2023-05-23T12:04:28Z",
      "convertedAccountId": "152996285",
      "convertedContactId": "418941",
      "convertedDealId": "8459821"
    }
  }