Lemlist Developer Docs

{
  "_id": "<string>",
  "teamId": "<string>",
  "watchListId": "<string>",
  "receivedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "signalData": {
    "jobTitle": "<string>",
    "jobDescription": "<string>",
    "jobLocation": "<string>",
    "jobUrl": "<string>",
    "jobStatus": "<string>",
    "recruiterName": "<string>",
    "recruiterTitle": "<string>",
    "recruiterLinkedinUrl": "<string>",
    "recruiterEmail": "<string>",
    "websiteVisited": "<string>",
    "visitorWebsite": "<string>",
    "visitorCountry": "<string>",
    "visitorDuration": 123,
    "startDate": "<string>",
    "previousCompany": "<string>",
    "previousCompanyLinkedinUrl": "<string>",
    "trackedCompanyUrl": "<string>",
    "linkedinPeopleProfilePostUrl": "<string>",
    "linkedinPeopleProfilePostContent": "<string>",
    "linkedinPeopleProfilePostCreatorName": "<string>",
    "linkedinPeopleProfileType": "<string>",
    "linkedinPeopleProfileMentionContent": "<string>",
    "linkedinPeopleProfileTrackedContactUrl": "<string>",
    "linkedinPeopleProfileDate": "<string>",
    "linkedinCompanyProfilePostUrl": "<string>",
    "linkedinCompanyProfilePostContent": "<string>",
    "linkedinCompanyProfilePostCreatorName": "<string>",
    "linkedinCompanyProfileType": "<string>",
    "linkedinCompanyProfileMentionContent": "<string>",
    "linkedinCompanyProfileTrackedCompanyUrl": "<string>",
    "linkedinCompanyProfileDate": "<string>",
    "linkedinKeywordsPostUrl": "<string>",
    "linkedinKeywordsPostContent": "<string>",
    "linkedinKeywordsPostCreatorName": "<string>",
    "linkedinKeywordsType": "<string>",
    "linkedinKeywordsMentionContent": "<string>",
    "linkedinKeywordsMatchedKeywords": "<string>",
    "linkedinKeywordsLocation": "<string>",
    "linkedinKeywordsDate": "<string>",
    "linkedinKeywordsPostCreatorUrl": "<string>",
    "linkedinKeywordsPostCreatorCompanyUrl": "<string>",
    "customSignalTitle": "<string>",
    "customSignalQuestion": "<string>",
    "customSignalAnswer": "<string>",
    "customSignalConfidence": 123,
    "customSignalLongAnswer": "<string>",
    "customSignalHeadlines": "<string>",
    "customSignalSources": "<string>",
    "fundingType": "<string>",
    "fundingStage": "<string>",
    "fundingAmountUsd": 123,
    "fundingAmountNative": 123,
    "fundingCurrency": "<string>",
    "fundingInvestors": "<string>",
    "fundingSourceUrl": "<string>",
    "buyingIntentTopics": "<string>",
    "buyingIntentTopTopic": "<string>",
    "competitorReactionsTrackedContactUrl": "<string>",
    "competitorReactionsPostUrl": "<string>",
    "competitorReactionsPostContent": "<string>",
    "competitorReactionsPostCreatorName": "<string>",
    "competitorReactionsEngagementType": "<string>",
    "competitorReactionsMentionContent": "<string>",
    "competitorReactionsDate": "<string>",
    "acquisitionType": "<string>",
    "acquirerName": "<string>",
    "acquirerWebsite": "<string>",
    "acquireeName": "<string>",
    "acquireeWebsite": "<string>",
    "dealPriceUsd": 123,
    "dealCurrency": "<string>",
    "announcementDate": "<string>",
    "acquirerCrunchbaseUrl": "<string>",
    "acquireeCrunchbaseUrl": "<string>",
    "technologyChangeName": "<string>",
    "technologyChangeSourceType": "<string>",
    "technologyChangeFirstSeenAt": "<string>",
    "technologyChangeLastSeenAt": "<string>",
    "technologyChangeCompanyName": "<string>",
    "technologyChangeCompanyDomain": "<string>",
    "promotionJobTitle": "<string>",
    "promotionFormerJobTitle": "<string>",
    "promotionStartDate": "<string>",
    "externalSignalCustomFields": {}
  },
  "watchListName": "<string>",
  "contact": {
    "_id": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>",
    "jobTitle": "<string>",
    "phone": "<string>",
    "linkedinUrl": "<string>",
    "picture": "<string>"
  },
  "company": {
    "_id": "<string>",
    "name": "<string>",
    "domain": "<string>",
    "linkedinUrl": "<string>",
    "industry": "<string>",
    "picture": "<string>"
  }
}

A signal detected by a Signal Agent representing a tracked event (hiring, LinkedIn activity, website visit, etc.)

_id

string

required

Unique signal identifier

teamId

string

required

Team ID that owns this signal

watchListId

string

required

ID of the Signal Agent associated with this signal

type

enum<string>

required

Signal type

Available options:

companyIsHiring,

companyRaisedFunds,

recruitmentCampaign,

jobChange,

newHire,

companyEmployeeVisitedMyWebsite,

customSignals,

competitorConnections,

competitorReactions,

companyFollowers,

technologyChange,

linkedinPeopleProfile,

linkedinCompanyProfile,

mergersAcquisitions,

promotion,

linkedinKeywords,

externalSignalContact,

externalSignalCompany,

buyingIntent

status

enum<string>

required

Signal status (computed based on user actions)

Available options:

new,

old,

handled,

ignored

receivedAt

string<date-time>

required

When the signal was received

createdAt

string<date-time>

required

When the signal was created in the database

signalData

object

required

Signal-specific data that varies by signal type. Each field is prefixed with the signal type(s) that populate it.

Show child attributes

watchListName

string

Name of the Signal Agent associated with this signal

contact

object

Contact associated with this signal (if entity type is 'contact')

Show child attributes

company

object

Company associated with this signal

Show child attributes

Company Note Signal Agents / Watch List

⌘I