# WS

Take advantage of Clearout’s integration with WS Form to clean the email contacts in real time basis

Are your online forms collecting temporary, disposable, role-based, gibberish or mistyped leads?\
Identify and remove such invalid leads at the time of capture on WS Forms by integrating them with Clearout Email Validator.\
Now upgrade the quality of leads effortlessly.

## Steps To Integrate WS Forms With Clearout WordPress Plugin <a href="#l65tx" id="l65tx"></a>

{% stepper %}
{% step %}
**Log in** to your Clearout account, navigate to the ‘**Developer**’ section. Click on '**+Create API Token**,' add a name and description, then click **Create**.

<figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FFFG7qALkaa5uP1fbxilK%2FClearout-API-Token-creation.png?alt=media&#x26;token=b973bfc9-5ab1-4d09-a119-91a6fe291c34" alt="Clearout API Token Creation for Fluent Form Integration"><figcaption></figcaption></figure>

You’ll see the API token. **Copy Clearout API Token**, then go back to your WordPress site.

<figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FDA5RODnxQTaiAtmRbfQe%2FClearout-API-Token-WS%20forms-copying.png?alt=media&#x26;token=f5da13ab-820f-4618-826c-5d48a4a65ec2" alt="Copy Clearout API Token Creation for WS Form Integration"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Set up the Clearout Email Validator plugin. Go to your form **Settings** > **Clearout Email Validator** *(make sure you’ve activated the plugin)*, **paste** your Clearout API token.

{% hint style="info" %} <mark style="color:$info;">**NOTE**</mark>:&#x20;

By default, the plugin will block role-based addresses and disposable addresses. You can allow either or both by choosing the checkboxes in the settings.
{% endhint %}

You can also enable "**Accept only Business Address as valid**", which will override all the other settings.

<figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FTFALQEelW8yBEMm2sz7q%2Fplugin-setting.png?alt=media&#x26;token=2a2fc88a-aa9c-4fa7-ab28-8245095688dd" alt="WordPress settings of Clearout Email Validator Plugin"><figcaption></figcaption></figure>

Navigate down to '**Apply Validation**' > Select **Forminator Form** > Click on **Apply** to activate the validation.

<figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FyrT6TYh8YkDEccJRoZND%2FScreenshot-2021-11-02-at-8.54.55-PM-1024x375.png?alt=media&#x26;token=0eb2ade8-2d6f-41f4-b2b0-c29d7a1e3bf6" alt="WordPress settings of Clearout Email Validator Plugin for WS Form"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
We have a **Test** Plugin option at the bottom of the plugin settings page, allowing you to test the settings and see sample error messages.

<figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2Fybdp8RYI39PmflaBmONb%2Ftest-plugin-1024x535.png?alt=media&#x26;token=cdbd72d0-011e-4797-949f-7bc994b01005" alt="Clearout WordPress plugin setup testing"><figcaption></figcaption></figure>

That's it! Below is **an example** of a WS Form integrated with Clearout, identifying an invalid email address in real-time.

<figure><img src="https://93738666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEXQQW0hsXyH0YD4ePoxb%2Fuploads%2FaBx4AcIEnMojaWxoTR2B%2Fimage5.png?alt=media&#x26;token=7effe6b9-55c6-4747-b4c6-661ed7a736a4" alt="Clearout WordPress Plugin Integrated WS Form Test Sample"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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.clearout.io/integrations/forms/ws.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.
