Job change monitoring: know when a contact changes jobs

Job change monitoring watches a list of contacts and raises an event when one of them changes jobs. Use it to keep your own contact records current, or to follow key contacts without checking each one by hand.

What it tells you

• Whether a contact on your list has changed jobs since the last check, recorded as an event you can read whenever you want.
• The monitor itself: its name, its id and whether it is active.
• How often the list is rechecked, which is weekly.
• Whether email alerts are on, and whether events are also pushed to an address you control.
• The signing secret for those pushed events, returned once when you create the monitor with an address set.

What you need to provide

• A name for the monitor. That is the only required input.
• Optional: switch email alerts off for this monitor.
• Optional: an HTTPS address to receive change events as they are detected.
• Once the monitor exists, the contacts to watch, each given as a profile link with an optional label.

What it costs

5 credits per contact per weekly recheck. Creating and managing monitors costs nothing, and contacts whose profiles cannot be reached are not charged. Live per-product costs are shown on the Billing page in your dashboard.

How to run it

• From your code: POST /v1/job-change-monitors, then see the Developer Hub at app.1lookup.io/developer-hub.
• From there you can list monitors, add contacts and page through detected changes.

Good to know

• Results are point-in-time. Every event comes from the latest weekly recheck, and a person can move again between checks, so a result is current as of that check, not settled.
• The webhook signing secret is returned only when the monitor is created. Save it then, because it is not shown again.
• Contacts are people, so this is personal data. Use it for legitimate business purposes only.
• Email alerts stay on unless you turn them off for that monitor.

Updated on: 24/08/2026