Skip to main content
POST
/
intents
/
leads
/
track_job_changes
Track job changes
curl --request POST \
  --url https://app.prontohq.com/api/v2/intents/leads/track_job_changes \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "webhook_url": "https://your-company.com/webhooks/job_changes",
  "linkedin_profile_urls": [
    "https://www.linkedin.com/in/john-doe",
    "https://www.linkedin.com/in/jane-smith"
  ]
}
'
{
  "id": "abc123",
  "status": "pending"
}

Documentation Index

Fetch the complete documentation index at: https://docs.prontohq.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows you to monitor job changes for a list of contacts on LinkedIn. When any of the tracked contacts changes their job, you’ll receive a notification through the specified webhook URL.

​
Use Cases

  • Monitor when your champions or product users change jobs
  • Track career movements of potential leads
  • Stay informed about your network’s professional changes

​
Important Notes

  • You can identify contacts either by their LinkedIn URL or by their name and current company
  • The system checks for job changes daily

​
Contact Identification

You can identify contacts in two ways:
  1. Using LinkedIn URL 
    {
  "linkedin_url": "https://www.linkedin.com/in/mathieu-brun-picard/"
}
  2. Using Name and Company 
    {
  "first_name": "Nicolas",
  "last_name": "Fernandez Le Follic",
  "company_name": "Pronto"
}

​
Webhook Notifications

When a contact changes their job, you’ll receive a webhook notification with details about the change. Make sure your webhook endpoint is ready to receive POST requests.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
webhook_url
string<uri>
required

URL to receive job change notifications

Example:

"https://your-company.com/webhooks/job_changes"

​
linkedin_profile_urls
string<uri>[]
required

List of LinkedIn profile URLs to track for job changes

Example:
[
  "https://www.linkedin.com/in/john-doe",
  "https://www.linkedin.com/in/jane-smith"
]

Response

Job change tracking initiated

​
id
string

Unique identifier for the tracking search

Example:

"abc123"

​
status
string

Status of the tracking search

Example:

"pending"