Webhooks Overview

Real-time webhooks for validation results

Clearout Webhooks send real-time notifications for email validation, email finder, and form guard operations. Webhooks deliver data to your application immediately instead of polling our APIs. You can build real-time integrations with webhooks to process verification results, update databases, trigger follow-up actions, or notify users without manual intervention.

Clearout provides webhook authentication to ensure secure delivery, allowing your application to verify the authenticity of each webhook request before processing the payload. This helps protect your endpoint from spoofed or tampered requests

Webhook vs API

APIs send you data when you request it. With Webhooks, you don't need to make requests - you receive data automatically when it's available.

Example

If you need to know whether an email finder is complete, using APIs requires you to keep polling every few seconds until the process finishes. However, with webhooks, you can configure a webhook event like email_finder.instant.completed to receive notifications automatically when email finder completes.

Use Cases

Webhooks can be used for multiple purposes. Here are some common use cases:

Use Case	Description	Primary Benefit
Real-time Notifications	Receive instant alerts when email validation, discovery, or Form Guard operations are completed.	Allows you to immediately inform users of results or trigger prompt follow-up actions.
Automated Workflows	Automatically sync validation data with your CRM, database, or internal workflow tools.	Eliminates the need for manual data entry and ensures systems are updated without human intervention.
Integration Automation	Connect Clearout services with existing platforms to create seamless automated pipelines.	Replaces the need for constant API polling, saving server resources and improving efficiency.

How Webhooks Work

When you configure a webhook in Clearout:

• You specify a URL endpoint where you want to receive notifications

• You choose which events to subscribe to (e.g., email validation complete, bulk verification finished)

• When an event occurs, Clearout sends an HTTP POST request with JSON payload to your configured URL

• To validate deliveries via webhooks, your application verifies the webhook authentication details to confirm the request came from Clearout.​

• After verification succeeds, your application processes the webhook data and takes the appropriate action.

Important

Despite network issues, webhooks ensure you receive results even if your initial API request fails or returned with unknown status

Webhook URLs must be publicly accessible and support HTTPS.

Good to know

Webhook events themselves are not charged. In the event of a request timeout or an unknown status response, you are charged for the service request action that was previously unsuccessful or returned unknown. Refer to Webhook Events & Payloads for details on specific events, and check our Pricing Guide to understand how much is charged for each service action.