Webhook Events & Payloads

Reference webhook events and payload structures for Clearout APIs

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 the 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
form_guard.phone_validation.completed	After phone validation in forms is completed
form_guard.name_validation.completed	After name 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": "[e-mail]",
      "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": "[e-mail]",
          "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": "69f0621ac1b2d86092997d45",
  "event_type": "form_guard.email_validation.completed",
  "event_mode": "live",
  "event_created_on": "2026-04-28T07:30:34.280Z",
  "payload": {
    "status": "success",
    "data": {
      "result": {
        "email_address": "[e-mail]",
        "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": "2026-04-28T07:30:31.958Z",
        "time_taken": 2282,
        "disposable": "no",
        "free": "no",
        "role": "no",
        "gibberish": "no",
        "bounce_type": "",
        "detail_info": {
          "account": "us",
          "domain": "clearout.io",
          "mx_record": "aspmx.l.google.com",
          "smtp_provider": "gsuite"
        },
        "profile": null
      },
      "page_url": "https://clearout.io/form-guard/",
      "name": "clearout_formguard",
      "version": "3.5.0"
    }
  }
}

form_guard.phone_validation.completed

Triggered when phone validation in forms is completed.

Payload Example

{
  "event_id": "69f06158c1b2d86092997d0e",
  "event_type": "form_guard.phone_validation.completed",
  "event_mode": "test",
  "event_created_on": "2026-04-28T07:27:20.376Z",
  "payload": {
    "status": "success",
    "data": {
      "result": {
        "status": "valid",
        "line_type": "fixed_line",
        "carrier": "TERRA NOVA",
        "location": "TROY, MI",
        "country_name": "United States of America",
        "country_timezone": "America/New_York",
        "country_code": "US",
        "country_utcoffset": "-05:00",
        "country_dstobservedhrs": -1,
        "international_format": "[phone]",
        "local_format": "[phone]",
        "e164_format": "[phone]",
        "can_be_internationally_dialled": "yes",
        "validated_on": "2026-05-12T12:42:38+00:00",
        "time_taken": 3
      },
      "page_url": "https://clearout.io/form-guard/",
      "name": "clearout_formguard",
      "version": "3.5.0"
    }
  }
}

form_guard.name_validation.completed

Triggered when name validation in forms is completed.

Payload Example

{
  "event_id": "69f05c595b1eebdb91601b92",
  "event_mode": "test",
  "event_type": "form_guard.name_validation.completed",
  "event_created_on": "2026-04-28T07:05:42.251Z",
  "payload": {
    "status": "success",
    "data": {
      "result": {
        "input_name": "Elon Musk",
        "status": "valid",
        "regex_result": "valid",
        "profanity": false,
        "gibberish": false,
        "normalized_name": "Elon Musk",
        "time_taken": 235
      },
      "page_url": "https://clearout.io/form-guard/",
      "name": "clearout_formguard",
      "version": "3.5.0"
    }
  }
}

Next Steps

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