Skip to main content
POST
/
intents
/
leads
/
track_job_changes
Track job changes for specific contacts
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://prontohq.com/webhooks/track_job_changes",
  "contacts": [
    {
      "first_name": "Mathieu",
      "last_name": "Brun-Picard",
      "linkedin_url": "https://www.linkedin.com/in/mathieu-brun-picard/"
    },
    {
      "first_name": "Nicolas",
      "last_name": "Fernandez Le Follic",
      "company_name": "Pronto"
    }
  ]
}
'
{
  "message": "Job changes tracking created successfully. Next run will be in 24 hours."
}
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

Your API key

Body

application/json
​
webhook_url
string<uri>
required

URL to receive job change notifications

Example:

"https://prontohq.com/webhooks/track_job_changes"

​
contacts
object[]
required

List of contacts to track

Minimum array length: 1
  • Option 1
  • Option 2
Example:
[
  {
    "first_name": "Mathieu",
    "last_name": "Brun-Picard",
    "linkedin_url": "https://www.linkedin.com/in/mathieu-brun-picard/"
  },
  {
    "first_name": "Nicolas",
    "last_name": "Fernandez Le Follic",
    "company_name": "Pronto"
  }
]

Response

Successfully created job changes tracking

​
message
string

Success message

Example:

"Job changes tracking created successfully. Next run will be in 24 hours."