Webhooks

Learn how to use webhooks to get alerts on subscriber and post events.

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"
}

Last updated

Was this helpful?