Contact Data Models

Represents a person associated with an account

Model IDEvent Data KeyDescription
crm_contact_infoinfo
crm_contact_addressesaddresses
crm_contact_phonesphones
crm_contact_emailsemails
crm_contact_custom_fieldscustomFields
User Mapped FieldsuserMappedFieldsField Mappings done via Mapping Presets

Contact Info

Model ID: crm_contact_info

NameTypeDescription
idString
firstNameString
lastNameString
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
updatedAtDate
createdAtDate
lastActivityAtDate
accountStringThe Account ID that is associated with the contact

Contact Addresses

Model ID: crm_contact_addresses

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

Contact Phones

Model ID: crm_contact_phones

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

Contact Emails

Model ID: crm_contact_emails

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

Custom Fields

Model ID: crm_contact_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": "101",
      "firstName": "Kendall",
      "lastName": "Roy",
      "description": "Senior Executive",
      "industry": "Entertainment",
      "jobTitle": "CEO",
      "owner": {
        "id": "407425865",
        "email": "[email protected]"
      },
      "createdBy": {
        "id": "51501658",
        "email": "[email protected]"
      },
      "updatedAt": "2023-05-23T12:04:54Z",
      "createdAt": "2023-05-23T12:04:54Z",
      "lastActivityAt": "2023-05-23T12:04:28Z",
      "account": "15913301322"
    },
    "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]"
      }
    ]
  }