How to get the list of Leads

You can use the following to fetch the list of leads from your integrations:

Syncs (Webhook-based Bulk Reads)

Syncs provide an automated, push-based approach for bulk data retrieval. Once you set up a sync for an integration, Knit polls the source app for changes and sends updates straight to your webhook. This webhook-based model eliminates the need for you to continuously pull data.

Read more about syncs and webhooks here: https://developers.getknit.dev/docs/register-webhook-url#/

Data Model

Model ID	Event Data Key	Description
`crm_lead_info`	`info`
`crm_lead_addresses`	`addresses`
`crm_lead_phones`	`phones`
`crm_lead_emails`	`emails`
`crm_lead_conversion`	`conversion`
`crm_lead_custom_fields`	`customFields`
`User Mapped Fields`	`userMappedFields`	Field Mappings done via Mapping Presets

Lead Info

Model ID: crm_lead_info

Name	Type	Description
`id`	`String`
`firstName`	`String`
`lastName`	`String`
`company`	`String`
`description`	`String`
`industry`	`String`
`jobTitle`	`String`
`owner`	`User`	Please refer to https://developers.getknit.dev/reference/base-models#user
`createdBy`	`User`	Please refer to https://developers.getknit.dev/reference/base-models#user
`annualRevenue`	`String`
`numberOfEmployees`	`Double`
`status`	`String`
`website`	`String`
`updatedAt`	`Date`
`createdAt`	`Date`
`lastActivityAt`	`Date`

Lead Addresses

Model ID: crm_lead_addresses

Name	Type	Description
`addresses`	`List[Address]`	Please refer to https://developers.getknit.dev/reference/base-models#address

Lead Phones

Model ID: crm_lead_phones

Name	Type	Description
`phones`	`List[Phone]`	Please refer to https://developers.getknit.dev/reference/base-models#phone

Lead Emails

Model ID: crm_lead_emails

Name	Type	Description
`emails`	`List[Email]`	Please refer to https://developers.getknit.dev/reference/base-models#email

Lead Conversion

Model ID: crm_lead_conversion

Name	Type	Description
`convertedAt`	`Date`
`convertedAccountId`	`String`
`convertedContactId`	`String`
`convertedDealId`	`String`

Custom Fields

Model ID: crm_lead_custom_fields

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

Name	Type	Description
`fields`	`Map<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

Name	Type	Description
`fields`	`Map<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": "kendall@waystar.com"
      },
      "createdBy": {
        "id": "407425865",
        "email": "kendall@waystar.com"
      },
      "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": "matson@gojo.com"
      }
    ],
    "conversion": {
      "convertedAt": "2023-05-23T12:04:28Z",
      "convertedAccountId": "152996285",
      "convertedContactId": "418941",
      "convertedDealId": "8459821"
    }
  }