Skip to content
Webhooks

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-Signaturestringrequired

HMAC-SHA256 of the raw request body, keyed with your workspace signing secret. See webhook security for how to verify it.

Content-Typestringrequired

Always application/json.

Common fields

idstringrequired

Unique to this event. The same id is sent again on a retry.

typestringrequired

One of the event types on this page.

created_atstring<date-time>required

When the event happened, in UTC.

dataobjectrequired

The fields listed under each event below.

bulk.completed

WEBHOOKbulk.completedfrom Bulk API

Sent when: a bulk job has a result or an error for every row.

Body

data.job_idstringrequired

The job that finished, as returned when you submitted it.

data.productstringrequired

The product slug the job ran.

data.rowsintegerrequired

Rows submitted.

data.succeededintegerrequired

Rows that returned a result.

data.failedintegerrequired

Rows that returned a row-level error. These are not charged.

data.credits_usedintegerrequired

Credits the job spent.

data.results_urlstring<uri>required

Where to fetch the results. Requires your API key.

Example

bulk.completed
{
  "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

WEBHOOKmonitor.job_changefrom Job Change Monitoring

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 status

Whether the contact is being monitored.

data.frequencyFrequency

How often the contact is checked: weekly, monthly or quarterly.

data.last_checked_atLast check

When the latest scheduled check ran.

data.next_check_atNext check

When the following check is due.

data.change_detectedChange detected

True when the last check found a new company or title.

data.change.typeChange type

company_change for a move to a new employer, title_change for a new role at the same one.

data.change.previousPrevious role

The title and company on record before the change.

data.change.currentNew role

The title and company found at the check, with a start date when available.

Example

monitor.job_change
{
  "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

WEBHOOKvisitor.identifiedfrom Website Visitor ID

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 level

company or person. Person-level matches happen only for consenting visitors in the US.

data.company.nameCompany

The organization the visitor was matched to.

data.company.domainCompany domain

The matched company's website, a clean key for your CRM.

data.company.employee_rangeCompany size

Headcount band for qualifying the account.

data.personPerson

Name, job title and email for a consenting US visitor. Null on company-level matches.

data.visit.landing_pageLanding page

The first page of the session, with referrer, page count and duration beside it.

data.identified_atIdentified at

UTC timestamp for when the visitor was identified.

Example

visitor.identified
{
  "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

WEBHOOKcredits.lowfrom Account

Sent when: your balance fell below the alert threshold you set.

Body

data.credits_remainingintegerrequired

Your balance when the event was sent.

data.thresholdintegerrequired

The alert threshold set in the dashboard.

Example

credits.low
{
  "id": "evt_c63d18f0e4",
  "type": "credits.low",
  "created_at": "2026-11-19T08:12:30Z",
  "data": {
    "credits_remaining": 87,
    "threshold": 100
  }
}