> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dovetail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage a source

> Check a source’s status, sync, pause, or reconnect it, change its connected account or settings, add or delete datasets, or delete the source.

<Info>
  Workspace admins and the user who connected a source (shown as **Connected by**) can manage it. Users with **Can use** on the source can open it and see its details. See [Manage source access](/help/sources/source-access).
</Info>

<img src="https://mintcdn.com/dovetail-e5aa4160/1b-Ww3vZoWIN7q0Y/images/03.-manage-source.jpg?fit=max&auto=format&n=1b-Ww3vZoWIN7q0Y&q=85&s=0f9d3d4e6354dc360633169923bf9208" alt="03 Manage Source" width="1456" height="968" data-path="images/03.-manage-source.jpg" />

## Open a source

In the sidebar, select **Sources**, then select the source. The source opens with these details:

* **Connected** and **Connected by**: when the source was created and who connected it.
* **Last sync**: when the source last synced. API and Zapier sources show **Last pushed** instead.
* **Data points ingested**: how many data points the source has imported.
* The source’s datasets, such as **Connected teams** for Gong, each with its own status.

If you don’t have **Can use** on a source, you can’t open it. See [Request access](/help/sources/source-access#request-access).

Users who can manage the source also see **Source actions** (`•••`) in its header, which holds the actions on this page and the options in [Source fields](/help/sources/source-fields).

***

## Source statuses

Each source shows one status.

| Status | What it means | What to do |
| :- | :- | :- |
| **Active** | The source is connected and syncs about every hour. | Nothing. |
| **Paused** | A user who manages the source paused syncing. No new data is imported, and data already imported stays where it is. | Select `Resume sync`. See [Pause and resume syncing](#pause-and-resume-syncing). |
| **Check connection** | Dovetail can’t read one or more datasets, for example because access was removed or the item was deleted in the tool. The other datasets keep syncing, and Dovetail retries the failed ones automatically. | Read the reason shown in the source. Fix access in the tool, then select `Sync now`. If the item no longer exists in the tool, [delete the dataset](#delete-a-dataset). |
| **Disconnected** | The source’s authorization is missing, revoked, or expired. Nothing syncs until the source is reconnected. | Select `Reconnect`. See [Reconnect a source](#reconnect-a-source). |

If data is missing from a channel and the source looks healthy, see [Missing or outdated data](/help/sources/troubleshooting#missing-or-outdated-data).

***

## Sync a source now

Sources sync automatically about every hour. To sync right away:

1. Open the source.
2. Select **Source actions** (`•••`) → `Sync now`.

Use `Sync now` after you fix the cause of a **Check connection** status, so Dovetail retries without waiting for the next automatic attempt.

`Sync now` isn’t available while the source is **Paused** or **Disconnected**. You can also start a sync from a channel’s **Sources** dialog. See [Sync a source now in a channel](/help/channels/channel-setup#sync-a-source-now).

***

## Pause and resume syncing

Pausing stops a source from importing new data. Data it has already imported stays in the source and in every channel that uses it, so pausing is the way to stop importing without losing anything.

To pause a source, open it and select **Source actions** (`•••`) → `Pause sync`. Pausing applies to the whole source. You can’t pause a single dataset.

To start again, select **Source actions** (`•••`) → `Resume sync`. The source picks up from where it left off, so data created in the tool while the source was paused is imported on the next sync. Some tools only make recent data available, so a long pause can leave a gap.

API and Zapier sources can’t be paused. To stop them, stop sending data from your system or Zap.

***

## Reconnect a source

When a source is **Disconnected**, for example because the connecting account lost access or a token expired, select **Source actions** (`•••`) → `Reconnect`. What happens next depends on how the integration connects:

* **Sign-in with the tool (OAuth):** you’re taken to the tool to sign in and approve access again. The source then runs on the account of the user who reconnected it.
* **Key, token, or key file:** you enter new credentials.

Syncing then resumes from where it left off. Reconnecting with a different account changes whose access the source uses for the whole workspace. See [Shared credentials](/help/sources/create-a-source#shared-credentials) before you choose an account.

You can also reconnect a source from a channel’s **Sources** dialog.

***

## Change the connected account

To see which account a source syncs with, open the source and select **Source actions** (`•••`) → `Connected account`. It shows the user who connected the account, the account in the tool, and when it was connected.

* `Reconnect` switches the source to your own account in the tool, without waiting for it to disconnect. Use it to hand a source over to another account.
* `Remove` unlinks the account. The source stops syncing and shows as **Disconnected** until it’s reconnected. Data it has already imported is kept.

API and Zapier sources don’t have a connected account.

***

## Add datasets

After a source is created, you can add more of the tool’s containers to it. For example, add another Front inbox or another Qualtrics survey.

1. Open the source.
2. At the end of the datasets list, select `Add {item}`, for example `Add inbox` or `Add survey`.
3. Select the items to add.
4. Choose an **Import period** for the new datasets. See [Import period](/help/sources/create-a-source#import-period).
5. Select `Save`.

The new datasets start importing right away. They aren’t added to channels that already use the source. To use them in a channel, add them from the channel’s **Sources** dialog. See [Add datasets or sources](/help/channels/channel-setup#add-datasets-or-sources).

Some integrations work differently. For example, API and Zapier sources ask for a dataset name instead. See the integration’s page in [Integrations](/integrations/home#sources).

***

## See which channels use a dataset

Select a dataset in the source to open it. **Connections using this dataset** lists each channel that uses it.

Users who can manage the source can also remove the dataset from a channel here. This takes the dataset’s data points out of that channel only: the data stays in the source and in any other channel that uses it. See [Remove a dataset or source](/help/channels/channel-setup#remove-a-dataset-or-source).

***

## Delete a dataset

<Warning>
  Deleting a dataset permanently deletes the data points it imported, in every channel that uses it. This can’t be undone.
</Warning>

1. Open the source and select the dataset.
2. Select **Dataset actions** (`•••`) → `Delete dataset`.
3. Check the channels listed in the confirmation, then select `Delete dataset`.

A source must keep at least one dataset. To remove the last one, delete the source instead.

To stop using a dataset in one channel without deleting its data, remove it from that channel. See [Remove a dataset or source](/help/channels/channel-setup#remove-a-dataset-or-source).

***

## Change redaction

Whether Dovetail redacts a source’s data is chosen when the source is created. Workspace admins and the user who connected the source can change it later in the source’s settings.

A change applies only to data the source imports afterward. Data already imported keeps the redaction it arrived with, in every channel that uses the source. To redact data that’s already been imported, contact Dovetail support at [support@dovetail.com](mailto:support@dovetail.com).

Dovetail redacts using your workspace’s redaction settings. For what redaction covers and how redacted text appears, see [Redact data from sources](/help/blur-and-redact#redact-data-from-sources).

***

## Change contact creation

For integrations whose data includes customer email addresses, a source can create contacts from those addresses and link its data points to them. New sources have this turned on by default.

To turn it on or off, open the source and change it in the source’s settings. The change applies everywhere the source is used. You need to be able to manage the source and to edit contacts.

For what contact creation does and which fields it fills in, see [Create contacts from source data](/help/contact-settings#create-contacts-from-source-data).

***

## Delete a source

<Danger>
  Deleting a source removes its data from every channel that uses it. This can’t be undone.
</Danger>

1. Open the source.
2. Select **Source actions** (`•••`) → `Delete source`.
3. Check the channels listed in the confirmation, then select `Delete source`.

The channels themselves aren’t deleted. They lose the data that came from this source.

To stop importing but keep the data, [pause the source](#pause-and-resume-syncing) instead. To revoke Dovetail’s access in the tool itself, see the integration’s page.

***

## Notifications

Dovetail sends an in-app notification and an email to the user who connected the source and to every workspace admin in two cases:

* **The source becomes Disconnected.**
* **A dataset keeps failing.** Dovetail retries a failed dataset automatically. If it still fails after those retries and the source feeds at least one channel, Dovetail sends this notification, at most once a day for each source.

***

## Related guides

<CardGroup cols={2}>
  <Card title="Manage source access" icon="users" href="/help/sources/source-access">
    Choose who can add a source’s data to channels.
  </Card>

  <Card title="Source fields" icon="list-checks" href="/help/sources/source-fields">
    Rename a source’s fields and change their types.
  </Card>

  <Card title="Troubleshoot sources" icon="life-buoy" href="/help/sources/troubleshooting">
    Find out why a source isn’t available or data is missing.
  </Card>

  <Card title="Channel setup" icon="signal" href="/help/channels/channel-setup">
    Add a source’s datasets to a channel, or remove them.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.