Webhook Events & Payloads

This page provides a complete reference for all Clearout webhook events and their payload structures. Each webhook event contains detailed information about the completed operation, allowing you to process results in real-time.

Event Timing

All webhook events are triggered immediately after the service completes.

Webhook Events Overview

Event Type	When Triggered
`email_verifier.instant.completed` *	After instant email verification completes
`email_verifier.bulk.completed`	After bulk email verification completes
`email_finder.instant.completed` *	After email finder operation completes
`email_finder.bulk.completed`	After bulk email finding completes
`form_guard.email_validation.completed` *	After email validation in forms is completed

* - Events that may be chargeable on a conditional basis, see our Pricing Guide for more details

Webhook Structure

All webhook payloads follow a consistent structure with common fields and service-specific data:

Common Fields

event_id - Unique identifier for this webhook delivery
event_type - The type of event that occurred
event_mode - Environment mode (live/test)
event_created_on - ISO 8601 timestamp when the event was created
payload - Contains the actual event data and results

Payload Structure

The payload object contains:

status - Overall operation status (success/error)
data - Service-specific data and results

Email Verifier Events

email_verifier.instant.completed

Triggered when instant email verification is completed.

Payload Example

{
  "event_id": "68b52198f204df746f72c3ec",
  "event_type": "email_verifier.instant.completed",
  "event_mode": "live",
  "event_created_on": "2025-09-01T04:31:20.445Z",
  "payload": {
    "status": "success",
    "data": {
      "email_address": "sanjay@socialfrontier.com",
      "status": "valid",
      "sub_status": {
        "code": 200,
        "desc": "Success"
      },
      "safe_to_send": "yes",
      "ai_verdict": "Given email address is from Gsuite provider, sending message will be delivered without a bounce",
      "suggested_email_address": "",
      "verified_on": "2025-09-01T04:31:20.042Z",
      "time_taken": 380,
      "disposable": "no",
      "free": "no",
      "role": "no",
      "gibberish": "no",
      "bounce_type": "",
      "detail_info": {
        "account": "sanjay",
        "domain": "socialfrontier.com",
        "mx_record": "aspmx.l.google.com",
        "smtp_provider": "gsuite"
      },
      "profile": null
    }
  }
}

Data Structure

The payload data structure is identical to the Email Verification API response. Refer to the Email Verification API documentation for detailed field descriptions.

email_verifier.bulk.completed

Triggered when bulk email verification is completed.

Payload Example

{
  "event_id": "68b18464a73994ef5ae36608",
  "event_type": "email_verifier.bulk.completed",
  "event_mode": "live",
  "event_created_on": "2025-08-29T10:43:48.077Z",
  "payload": {
    "status": "success",
    "data": {
      "list_id": "68b1821500b0b980de170e2d",
      "list_name": "clearout_email_verifier_sample_list.csv"
    }
  }
}

Email Finder Events

email_finder.instant.completed

Triggered when instant email finding is completed.

Payload Example

{
  "event_id": "68994705edd8dab364becfe6",
  "event_type": "email_finder.instant.completed",
  "event_mode": "live",
  "event_on": "2025-08-11T01:27:33.597Z",
  "payload": {
    "status": "success",
    "data": {
      "emails": [
        {
          "email_address": "sinha@clearout.io",
          "role": "no",
          "business": "yes"
        }
      ],
      "first_name": "sinha",
      "last_name": "",
      "full_name": "sinha",
      "domain": "clearout.io",
      "confidence_score": 99,
      "_depreciated": {
        "confidence_score": 92
      },
      "total": 1,
      "company": {
        "name": "clearout"
      },
      "found_on": "2025-08-11T01:27:33.564Z",
      "credits_charged": 4
    }
  }
}

Data Structure

The payload data structure is identical to the Email Finder API response. Refer to the Email Finder API documentation for detailed field descriptions.

email_finder.bulk.completed

Triggered when bulk email finding is completed.

Payload Example

{
  "event_id": "68b18464a73994ef5ae36608",
  "event_type": "email_finder.bulk.completed",
  "event_mode": "live",
  "event_created_on": "2025-08-29T10:43:48.077Z",
  "payload": {
    "status": "success",
    "data": {
      "list_id": "68b1821500b0b980de170e2d",
      "list_name": "clearout_email_verifier_sample_list.csv"
    }
  }
}

Form Guard Events

form_guard.email_validation.completed

Triggered when email validation in forms is completed.

Payload Example

{
  "event_id": "689c16f8759521043ae297e2",
  "event_type": "form_guard.email_validation.completed",
  "event_mode": "live",
  "event_created_on": "2025-08-13T04:39:20.774Z",
  "payload": {
    "status": "success",
    "data": {
      "email_address": "sanjaytest@kintra.com",
      "status": "valid",
      "sub_status": {
        "code": 200,
        "desc": "Success"
      },
      "safe_to_send": "yes",
      "ai_verdict": "Given email address is from Servicehoster provider, sending message will be delivered without a bounce",
      "suggested_email_address": "",
      "verified_on": "2025-08-13T04:39:18.955Z",
      "time_taken": 1795,
      "disposable": "no",
      "free": "no",
      "role": "no",
      "gibberish": "no",
      "bounce_type": "",
      "detail_info": {
        "account": "sanjaytest",
        "domain": "kintra.com",
        "mx_record": "mx02.servicehoster.ch",
        "smtp_provider": "servicehoster"
      },
      "profile": null
    }
  }
}

Data Structure

The payload data structure is identical to the Email Verification API response. Refer to the Email Verification API documentation for detailed field descriptions.

Next Steps

Now that you understand the webhook events and payloads, learn how to validate webhook deliveries for security and test your webhook integration.