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.
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
New Scraped Lead
Triggers when a new scraped lead has activity that matches a filter.
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
New Post from Keyword Monitoring
Triggers when a new post from keyword monitoring is scraped.
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
Last updated
Was this helpful?