# Implementation & Setup

## Getting Started

{% stepper %}
{% step %}

### Connect Your Data Source

#### Select Data Source

Choose the data source you want to connect.

<div data-with-frame="true"><figure><img src="/files/NbTsqVMzxZKmm3LKPGB0" alt=""><figcaption></figcaption></figure></div>

#### Select Enrichment Type

Choose the fields you want to enrich. You can select one or more enrichment options based on your requirements.

<div data-with-frame="true"><figure><img src="/files/QwCPoWp50aHfgwGedOGh" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
At least one field must be selected to continue.
{% endhint %}

Connect your Go-to-Stack data source (Salesforce, HubSpot, etc.) to begin.
{% endstep %}

{% step %}

### Configuring Data Field Mapping

Decide which fields require validation and define output metadata fields for appending.

#### Input Field Mappings

Map incoming fields from your data source to Data Pulse input fields to ensure accurate validation and enrichment. You can configure mappings using either a **preset** or by selecting **custom fields**.

Available presets:

* **Auto Map** - Automatically detects and maps fields based on the source structure.

<div data-with-frame="true"><figure><img src="/files/8mj6cVpzmh2qGU37owiC" alt=""><figcaption></figcaption></figure></div>

**Data Pulse Input Fields Reference**

<table><thead><tr><th width="166">Field Name</th><th>Description</th></tr></thead><tbody><tr><td><strong>First Name</strong></td><td>Given name associated with the contact</td></tr><tr><td><strong>Last Name</strong></td><td>Surname associated with the contact</td></tr><tr><td><strong>Full Name</strong></td><td>Combined name field (if available in source)</td></tr><tr><td><strong>Email</strong></td><td>Primary email address for validation and enrichment</td></tr><tr><td><strong>Phone</strong></td><td>Contact number for validation and formatting</td></tr><tr><td><strong>Country</strong></td><td>Geographic identifier used to determine the country dialling code during phone validation if the dialling code is not present in the number</td></tr></tbody></table>

#### Output Field Mappings

Choose which fields should be returned and synced back after enrichment. You can configure mappings using either a **preset** or by selecting **custom fields**.

Available presets:

* **All** - Selects every available output field.
* **Mandatory Fields** - Selects only the required fields.

<div data-with-frame="true"><figure><img src="/files/BHpVdEYHt1DiovMChUCK" alt=""><figcaption></figcaption></figure></div>

**Output Fields Reference**

{% tabs %}
{% tab title="Email" %}

| Clearout Field Name            | Description                                  |
| ------------------------------ | -------------------------------------------- |
| **Status** *(Mandatory)*       | Validation status of the email               |
| **Safe to Send** *(Mandatory)* | Indicates if the email is safe for outreach  |
| **Reason**                     | Reason associated with the validation result |
| **SMTP Provider**              | Identified email service provider            |
| {% endtab %}                   |                                              |

{% tab title="Phone" %}

| Clearout Field Name         | Description                                 |
| --------------------------- | ------------------------------------------- |
| **Status** *(Mandatory)*    | Validation status of the phone number       |
| **Carrier**                 | Telecom carrier information                 |
| **Country Name**            | Country associated with the number          |
| **Country Timezone**        | Timezone of the detected country            |
| **E164 Format**             | Standardized international format           |
| **Line Type** *(Mandatory)* | Type of phone line (mobile, landline, etc.) |
| **Location**                | Geographic location metadata                |
| **DST Observed Hrs**        | Hours adjusted for daylight saving time     |
| {% endtab %}                |                                             |

{% tab title="Name" %}

| Clearout Field Name         | Description                                     |
| --------------------------- | ----------------------------------------------- |
| **Gibberish** *(Mandatory)* | Indicates if the name appears invalid or random |
| **Status**                  | Validation result for the name                  |
| {% endtab %}                |                                                 |

{% tab title="Miscellaneous" %}

| Clearout Field Name           | Description                             |
| ----------------------------- | --------------------------------------- |
| **Enriched On** *(Mandatory)* | Timestamp when enrichment was performed |
| {% endtab %}                  |                                         |
| {% endtabs %}                 |                                         |

{% hint style="info" %}
You can save custom field mappings as a new preset. Saved presets can be reused for the same data source in future configurations. This applies to both import and output field mappings.
{% endhint %}
{% endstep %}

{% step %}

#### Activate Data Pulse

<div data-with-frame="true"><figure><img src="/files/xMhJ6z0sWQbQ6aH6xV4C" alt=""><figcaption></figcaption></figure></div>

Complete the setup wizard to activate real-time validation and enrichment.\
Weekly data quality report is **enabled by default**. You can opt-in or opt-out of the report here.
{% endstep %}
{% endstepper %}

### Continuous Monitoring & Automation

Once active, Data Pulse runs automatically in the background:

* Validates new data as it is added to connected sources
* Pauses real-time monitoring and disables all active accounts when credits are exhausted
* Sends you an email whenever monitoring pauses
* Resumes monitoring automatically for system disabled accounts when credits are replenished
* Sends you an email once Data Pulse is back online monitoring

<div data-with-frame="true"><figure><img src="/files/LC4qsRJOkmAEeuYqw8Vg" alt=""><figcaption></figcaption></figure></div>

### Disconnecting a Data Source

#### Stop Pulsing

To pause validation without removing the data source:

1. Go to the [**Data Pulse homepage**](https://app.clearout.io/data-pulse)
2. Click **Disable** against your data source
3. Confirm to stop real-time validation and enrichment

<div data-with-frame="true"><figure><img src="/files/k0xuft0UAZr8mKWjeeyS" alt=""><figcaption></figcaption></figure></div>

#### Remove Data Source

To fully disconnect and remove a data source:

1. Click the **three-dot menu (⋮)** for the data source
2. Select **Disconnect**

{% hint style="danger" %}
**Disconnecting removes the data source from Clearout entirely.** This may impact other features or workflows that rely on the same source.
{% endhint %}


---

# 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/data-pulse/implementation-and-setup.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.
