Leads

Checking for the API Key

We send a POST request to the webhook endpoints you specify. To verify that the request came from Letterdrop, check for a field in the header of the request with key api-key and make sure it matches the value in your Settings.

If the API Key is absent, you're getting hit up with requests from our evil twin from another dimension. Do not trust him under any circumstances!

New Engaged lead

Triggers when a new engaged lead has activity that matches a filter.

Key	Description	Type
name	Name	String
country	Country	String
job_title	Job Title	String
company_name	Company Name	String
company_size	Range of number of employees at company	String
linkedin_url	LinkedIn URL	URL
deal_stage	Deal Stage in HubSpot or Salesforce if lead belongs to a domain with an associated Deal/Opportunity	String
deal_amount	Deal Amount in HubSpot or Salesforce if lead belongs to a domain with an associated Deal/Opportunity	String
linkedin_vanity_name	LinkedIn Identifier	String
activities	Number of activities on LinkedIn: profile views, follows, connects, comments, likes	Number
webhook_type	"engaged_lead"	String
last_activity	Last activity on LinkedIn	String
company_country	Country of Copmany HQ	String
company_website	Domain of Company	URL
profile_picture	Link to LinkedIn profile picture of lead	URL
last_engaged_date	The last time the lead engaged with your team's LinkedIn	Date
first_engaged_date	The first time the lead engaged with your team's LinkedIn	Date
last_activity_type	Type of the last activity: like, comment, follower, viewed profile, connection	String
last_engaged_linkedin_post_body	Body of the last LinkedIn post the lead engaged with	String
last_engaged_linkedin_post_url	URL of the last LinkedIn post the lead engaged with	URL

Sample payload

{
  "name": "Jonah Mandel",
  "country": "United States",
  "job_title": "Vice President Of Global Sales",
  "activities": 1,
  "deal_stage": "S0",
  "deal_amount": $24,000,
  "company_name": "Guesty",
  "company_size": "501-1000",
  "linkedin_url": "https://www.linkedin.com/in/jonah-mandel-654290a2",
  "webhook_type": "engaged_lead",
  "last_activity": "Liked a post from Parthi Loganathan",
  "company_country": "US",
  "company_website": "guesty.com",
  "profile_picture": "https://cdn.letterdrop.co/pictures/7671965c-17db-4ae5-b3c8-b5606ed709c0",
  "last_engaged_date": "November 20th 2024",
  "first_engaged_date": "November 20th 2024",
  "last_activity_type": "like",
  "linkedin_vanity_name": "jonah-mandel-654290a2",
  "last_engaged_linkedin_post_url": "https://www.linkedin.com/posts/parthiloganathan_dont-underestimate-linkedins-potential-activity-7265363395380469760-NZxZ",
  "last_engaged_linkedin_post_body": "Don't underestimate LinkedIn's potential for enterprise sales prospecting. Many think you can't sell to enterprise this way. That's not true. Enterprise decision-makers are active on LinkedIn. They're just lurking..."
}

New Scraped Lead

Triggers when a new scraped lead has activity that matches a filter.

Key	Description	Type
name	Name of the lead	String
country	Country of the lead	String
job_title	Job Title of the lead	String
company_name	Company Name of the lead	String
company_size	Range of number of employees at company	String
linkedin_url	LinkedIn profile URL of the lead	URL
deal_stage	Deal stage in HubSpot or Salesforce if associated with a Deal/Opportunity	String
deal_amount	Deal amount in HubSpot or Salesforce if associated with a Deal/Opportunity	String
linkedin_vanity_name	LinkedIn Identifier	String
activities	Number of activities on LinkedIn: profile views, follows, connects, comments, likes	Number
webhook_type	"scraped_lead"	String
last_activity	Last activity on LinkedIn	String
company_country	Country of Company HQ	String
company_website	Domain of Company	URL
profile_picture	Link to LinkedIn profile picture of the lead	URL
last_engaged_date	The last time the lead engaged with your team's LinkedIn	Date
first_engaged_date	The first time the lead engaged with your team's LinkedIn	Date
last_activity_type	Type of the last activity: like, comment, follower, viewed profile, connection	String
last_engaged_linkedin_post_body	Body of the last LinkedIn post the lead engaged with	String
last_engaged_linkedin_post_url	URL of the last LinkedIn post the lead engaged with	URL

Sample Payload

{
  "name": "Jonah Mandel",
  "country": "United States",
  "job_title": "Vice President Of Global Sales",
  "activities": 1,
  "deal_stage": "S0",
  "deal_amount": "$24,000",
  "company_name": "Guesty",
  "company_size": "501-1000",
  "linkedin_url": "https://www.linkedin.com/in/jonah-mandel-654290a2",
  "webhook_type": "engaged_lead",
  "last_activity": "Liked a post from Parthi Loganathan",
  "company_country": "US",
  "company_website": "guesty.com",
  "profile_picture": "https://cdn.letterdrop.co/pictures/7671965c-17db-4ae5-b3c8-b5606ed709c0",
  "last_engaged_date": "November 20th 2024",
  "first_engaged_date": "November 20th 2024",
  "last_activity_type": "like",
  "linkedin_vanity_name": "jonah-mandel-654290a2",
  "last_engaged_linkedin_post_url": "https://www.linkedin.com/posts/parthiloganathan_dont-underestimate-linkedins-potential-activity-7265363395380469760-NZxZ",
  "last_engaged_linkedin_post_body": "Don't underestimate LinkedIn's potential for enterprise sales prospecting. Many think you can't sell to enterprise this way. That's not true. Enterprise decision-makers are active on LinkedIn. They're just lurking..."
}

New Post from Keyword Monitoring

Triggers when a new post from keyword monitoring is scraped.

Field Name	Description	Type
name	Name of the lead	String
country	Country of the lead	String
job_title	Job Title of the lead	String
company_name	Company Name of the lead	String
linkedin_url	LinkedIn profile URL of the lead	URL
linkedin_vanity_name	LinkedIn Identifier	String
lead_type	One of Prospect, Influencer, Competitor, Not Relevant	String
total_engagement	Number of likes and comments on the post	Number
webhook_type	"keyword_monitored_post"	String
likes_count	Number of likes on post	Number
comments_count	Number of comments on post	Number
profile_picture	Link to LinkedIn profile picture of the lead	URL
post_summary	Summary of the post	String
answer_to_prompt	Answer by AI on body of post	String
post_date	Date of LinkedIn post	Date
post_url	URL of LinkedIn post	URL
post_content	Body of the last LinkedIn post the lead engaged with	String
post_relevance_reason	Reason for why the post is relevant	String

Sample Payload

{
  "name": "Jonah Mandel",
  "job_title": "Vice President Of Global Sales",
  "company_name": "Guesty",
  "linkedin_url": "https://www.linkedin.com/in/jonah-mandel-654290a2",
  "webhook_type": "keyword_monitored_post",
  "profile_picture": "https://cdn.letterdrop.co/pictures/7671965c-17db-4ae5-b3c8-b5606ed709c0",
  "linkedin_vanity_name": "jonah-mandel-654290a2",
  "post_url": "https://www.linkedin.com/posts/parthiloganathan_dont-underestimate-linkedins-potential-activity-7265363395380469760-NZxZ",
  "post_content": "Don't underestimate LinkedIn's potential for enterprise sales prospecting. Many think you can't sell to enterprise this way. That's not true. Enterprise decision-makers are active on LinkedIn. They're just lurking..."
  "lead_type": "Prospect",
  "post_date": "October 1st 2024",
  "likes_count": 22,
  "company_name": "Company Name 1",
  "linkedin_url": "https://www.linkedin.com/in/lorem-ipsum-1",
  "post_summary": "LinkedIn can be used to prospect into enterprise accounts",
  "webhook_type": "keyword_monitored_post",
  "comments_count": 3,
  "profile_picture": "https://cdn.letterdrop.co/pictures/user-image-url-1",
  "answer_to_prompt": "Lorem Ipsum",
  "total_engagement": 25,
  "post_relevance_reason": "We help companies sell to enterprise"
}