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

Response

201
application/json

Successfully created job changes tracking

The response is of type object.