Webhooks - Overview

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.

Reliability with Timeouts

Despite network issues, webhooks ensure you receive results even if your initial API request fails or returned with unknown status. Once email validation, finder, or form guard operations are completed on our servers, the webhook will be sent to your endpoint regardless of the original request's status. You'll never miss important validation results.

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.

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:

Real-time Notifications

Get instant notifications when email validation completes, allowing you to immediately inform users about validation results or trigger follow-up actions in your application.

Automated Workflows

Automatically update your CRM, database, or other systems when validation results are available, eliminating the need for manual data entry or synchronization.

Integration Automation

Seamlessly integrate Clearout services with your existing tools and platforms, creating automated pipelines for email validation and processing.

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
  • Your application processes the webhook data and takes appropriate action
Important

Webhook URLs must be publicly accessible and support HTTPS.