Event types
Every event is a JSON POST with the same headers and the same outer fields. Only the data object changes from one event type to the next.
Headers
X-1Lookup-SignaturestringrequiredHMAC-SHA256 of the raw request body, keyed with your workspace signing secret. See webhook security for how to verify it.
Content-TypestringrequiredAlways application/json.
Common fields
idstringrequiredUnique to this event. The same id is sent again on a retry.
typestringrequiredOne of the event types on this page.
created_atstring<date-time>requiredWhen the event happened, in UTC.
dataobjectrequiredThe fields listed under each event below.
bulk.completed
Sent when: a bulk job has a result or an error for every row.
Body
data.job_idstringrequiredThe job that finished, as returned when you submitted it.
data.productstringrequiredThe product slug the job ran.
data.rowsintegerrequiredRows submitted.
data.succeededintegerrequiredRows that returned a result.
data.failedintegerrequiredRows that returned a row-level error. These are not charged.
data.credits_usedintegerrequiredCredits the job spent.
data.results_urlstring<uri>requiredWhere to fetch the results. Requires your API key.
Example
{
"id": "evt_41c0f7d2a9",
"type": "bulk.completed",
"created_at": "2026-11-19T10:41:07Z",
"data": {
"job_id": "job_7c1d9a42",
"product": "phone-validation",
"rows": 10000,
"succeeded": 9640,
"failed": 360,
"credits_used": 9640,
"results_url": "https://api.1lookup.dev/v1/bulk/job_7c1d9a42/results"
}
}monitor.job_change
Sent when: a watched contact changed company or title. The data object is the same result the Job Change Monitoring endpoint returns.
Body
data.statusWatch statusWhether the contact is being monitored.
data.frequencyFrequencyHow often the contact is checked: weekly, monthly or quarterly.
data.last_checked_atLast checkWhen the latest scheduled check ran.
data.next_check_atNext checkWhen the following check is due.
data.change_detectedChange detectedTrue when the last check found a new company or title.
data.change.typeChange typecompany_change for a move to a new employer, title_change for a new role at the same one.
data.change.previousPrevious roleThe title and company on record before the change.
data.change.currentNew roleThe title and company found at the check, with a start date when available.
Example
{
"id": "evt_9b27e4c1f6",
"type": "monitor.job_change",
"created_at": "2026-11-01T06:00:04Z",
"data": {
"monitor_id": "mon_4t9x2k7c",
"linkedin_url": "https://www.linkedin.com/in/jordan-avery-example",
"frequency": "monthly",
"status": "active",
"last_checked_at": "2026-11-01T06:00:00Z",
"next_check_at": "2026-12-01T06:00:00Z",
"change_detected": true,
"change": {
"type": "company_change",
"detected_at": "2026-11-01T06:00:00Z",
"previous": {
"title": "Director of Revenue Operations",
"company": "Northwind Logistics"
},
"current": {
"title": "VP of Revenue Operations",
"company": "Fabrikam Health",
"started": "2026-10"
}
}
}
}visitor.identified
Sent when: a visiting company or consenting person was identified. The data object is the same result the Website Visitor ID endpoint returns.
Body
data.match_levelMatch levelcompany or person. Person-level matches happen only for consenting visitors in the US.
data.company.nameCompanyThe organization the visitor was matched to.
data.company.domainCompany domainThe matched company's website, a clean key for your CRM.
data.company.employee_rangeCompany sizeHeadcount band for qualifying the account.
data.personPersonName, job title and email for a consenting US visitor. Null on company-level matches.
data.visit.landing_pageLanding pageThe first page of the session, with referrer, page count and duration beside it.
data.identified_atIdentified atUTC timestamp for when the visitor was identified.
Example
{
"id": "evt_5e80a3d7b2",
"type": "visitor.identified",
"created_at": "2026-11-12T15:42:09Z",
"data": {
"site": "example.com",
"visitor_id": "vis_8f3k2m9q4x",
"identified_at": "2026-11-12T15:42:08Z",
"match_level": "person",
"company": {
"name": "Fabrikam Health",
"domain": "fabrikam.example",
"industry": "Health care technology",
"employee_range": "501-1000",
"country": "US"
},
"person": {
"full_name": "Priya Raman",
"job_title": "Head of Revenue Operations",
"email": "priya.raman@example.com",
"consented": true
},
"visit": {
"landing_page": "https://example.com/pricing",
"referrer": "https://news.example/revops-tools",
"pages_viewed": 4,
"duration_seconds": 213,
"country": "US"
}
}
}credits.low
Sent when: your balance fell below the alert threshold you set.
Body
data.credits_remainingintegerrequiredYour balance when the event was sent.
data.thresholdintegerrequiredThe alert threshold set in the dashboard.
Example
{
"id": "evt_c63d18f0e4",
"type": "credits.low",
"created_at": "2026-11-19T08:12:30Z",
"data": {
"credits_remaining": 87,
"threshold": 100
}
}