# Clearout

The Clearout piece in ZBrain Flow provides integration with Clearout's email verification platform, allowing you to validate email addresses directly from your workflows. This connector enables you to instantly check email deliverability, reduce bounce rates, and ensure email list quality without manual verification. With Clearout integration, you can build automation that verifies email addresses at critical points in your business processes, cleans contact lists, and maintains high-quality email databases. This piece is ideal for businesses looking to improve email deliverability, protect their sender reputation, and ensure they're communicating with valid contacts.

### **How to Use Clearout in ZBrain Flow?** <a href="#how-to-use-clearout-in-zbrain-flow" id="how-to-use-clearout-in-zbrain-flow"></a>

**Step 1: Select Clearout as Your Connection**

* Click on the '+' button in the Flow and search for Clearout.
* Select Clearout.
* Decide on the action you need, then select it. ZBrain Flow provides two options:
  * **Instant Verify** – Check the validity and deliverability of an email address.
  * **Custom API Call** – Send a custom API call to a specific endpoint.

### **How to Validate Email Addresses Using Clearout in ZBrain Flow** <a href="#how-to-validate-email-addresses-using-clearout-in-zbrain-flow" id="how-to-validate-email-addresses-using-clearout-in-zbrain-flow"></a>

**Step 1: Connect to Clearout**

* From the ‘Connection' dropdown, click on 'Create connection.’
* If creating a new connection, provide:
  * A descriptive 'Connection Name'
  * Your 'API Token' from your Clearout account (found under Settings > API)
* Click 'Save' to create the connection.

**Step 2: Specify Email to Verify**

* In the 'Email' field, enter the email address you want to validate.

After configuration, this action will send the email address to Clearout's verification service and return detailed results about its validity.

### **How to Send a Custom API Call to a Specific Endpoint** <a href="#how-to-send-a-custom-api-call-to-a-specific-endpoint" id="how-to-send-a-custom-api-call-to-a-specific-endpoint"></a>

**Step 1: Connect to Clearout**

* To connect to your Clearout account, follow the first step in the "How to Validate Email Addresses Using Clearout in ZBrain Flow " section above.

**Step 2: Specify the API Endpoint**

* In the 'URL' field, enter the Clearout API base URL with the specific endpoint you want to access.

**Step 3: Select Request Method**

* From the 'Method' dropdown, choose the appropriate HTTP method (GET, POST, PUT, DELETE, etc.).

**Step 4: Configure Headers (Optional)**

* Click 'Add Item' in the 'Headers' section to add any custom headers. Note that authorization headers are automatically injected from your connection.

**Step 5: Add Query Parameters (Optional)**

* Click 'Add Item' in the 'Query Parameters' section to add URL parameters.

**Step 6: Provide Request Body (Optional)**

* For POST, PUT, or PATCH requests, enter the JSON data to send in the 'Body' field.

**Step 7: Set Error Handling (Optional)**

* Enable 'No Error on Failure' if you want the flow to continue even if the API request fails.
* Set a 'Timeout' value in seconds to limit the request duration.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/clearout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
