---
description: The Contacts reports tab consists of all the metrics and information related to Contacts.
title: Reports: Contacts
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[New🌍 WhatsApp API Calling is now available globally! Start making calls with respond.io today. Learn more![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/whatsapp-business-calling-api)

Help me with... ⌘ 

1. [All Collections >](/help)
2. [ Product >](/help/product)
3. [ Dashboard & Reporting >](/help/dashboard-reporting)
4. Reports: Contacts

# Reports: Contacts

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/4IHLTWbmWN0uXBc5x4jthC/59252fcdb357304ce07be76043047b7a/Susan_Swier_Avatar.svg)

Susan Swier

· 29 May 2025

4 min read

The Contacts report provides metrics regarding Contacts in a Workspace. Gain insights on the number of Contacts added, connected, deleted and merged, as well as identifying popular Contact sources and channels used.

The new Paid Ads source category includes both Meta Click-to-Chat Ads and TikTok Messaging Ads. This makes it easier to track how many Contacts were acquired through your advertising efforts. These will appear in both the bar and pie charts under the “Paid Ads” group.

> Paid Ads: Contacts added by clicking a Meta or TikTok advertisement and initiating a message. Sub-sources (Meta or TikTok) are also tracked in logs.

## Getting Here

Navigate to the **Reports** module and click **Contacts**.

## Filters

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2UsHd4FVVUF9osHczB8DZZ/658cc9e9c832a9b49e95a6f5c3269346/reports-filter.png?fm=jpg&q=80&w=483) 
* Frequency and date — Select a date range from the drop-down list to be applied to the report. Alternatively, you can define the date range by frequency. The following options are available:  
   * Today  
   * Yesterday  
   * Last 7 Days  
   * Last 14 Days  
   * Last 30 Days  
   * This Month  
   * Last Month
* +Add Filter — You can refine the view of the report components by adding more filter(s). The following filters are available:  
   * Channel - Channels that have been deleted from the Workspace are not available for selection. However, the report will include data from these deleted channels.  
   * User  
   * Source  
   * Contact - Search the Contact by Contact name and Contact ID. Use Contact filter to see the conversations for the specified Contact.
* Clear All — You can use this option to reset the filters to the default selections.

> You may encounter a chart with the following message displayed:  
> _\-The selected filter(s) are not applicable here_: This means the filter(s) you have selected are not applicable to the chart.  
> \- _The selected filter(s) have no applicable data_: This means no data is available for the selected filter(s), for e.g. the chart is new and only available at a date later than the selected date range.

## Report Components

### Contacts Overview

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3oLWAWB7Ef2KzfaCDeuSZO/9d0da127ab5dce22dcdf3faa51d9526a/contacts-contact-overview.png?fm=jpg&q=80&w=640) 

**Metric #1: Contacts Added**

The number of Contacts added within the selected period.

**Metric #2: Contacts Deleted**

The number of Contacts deleted within the selected period.

**Metric #3: Contacts Merged**

The number of Contacts merged within the selected period.

**Bar Chart: Contacts Added vs Deleted vs Merged**

The number of Contacts added, deleted and merged within the selected period.

### Contacts Added

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4a7tB92EzbhPRjJI2y34CG/6c6ec7b2f885cbab2c365ef33e72a49f/contacts-contacts-added.png?fm=jpg&q=80&w=640) 

**Metric**

The number of Contacts added within the selected period broken down by source, or how the Contacts were added.

The ways to add a Contact are as follows:

| Source                  | Description                                                                                                         |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------- |
| User                    | The Contact was added by a user via the Add Contact dialog in Contacts module or the Inbox module.                  |
| Contact Import          | The Contact was added via Contact Import in Contacts module.                                                        |
| Developer API           | The Contact was added via Contact API.                                                                              |
| Incoming Message        | The Contact was added when he/she sent an incoming message to the platform.                                         |
| Echo Message            | The Contact was added when his/her conversation was imported from the supported messaging channel such as Facebook. |
| Zapier                  | The Contact was added via a Zapier action.                                                                          |
| Make                    | The Contact was added via a Make action.                                                                            |
| Click-to-Chat Ad        | The Contact was added when they clicked an advertisement.                                                           |
| Auto-Create: HubSpot    | Contact was automatically added from HubSpot.                                                                       |
| Auto-Create: Salesforce | Contact was automatically added from Salesforce.                                                                    |

**Bar Chart**

The number of Contacts added within the selected period by source.

**Pie Chart**

The percentage and total number of Contacts added within the selected period by source.

### Contacts Connected

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2UhK1GrLEeOVvxyvcaaUef/ad6dbbf63f46baa05c9765b504158f1c/contacts-contacts-connected.png?fm=jpg&q=80&w=640) 

**Metric**

The number and percentage of newly-connected Contacts within the selected period broken down by channel. This report helps to identify the channels the new Contacts are coming from or added.

Contacts get connected ([active](https://respond.io/help/contacts/contact-channels#active%5Fchannel) on platform) when there is an outgoing message successfully sent to the Contact or when an incoming message is received from the Contact. The ways a Contact can be connected are as follows:

| Source           | Description                                                                                                       |
| ---------------- | ----------------------------------------------------------------------------------------------------------------- |
| Developer API    | The Contact was connected via an outgoing message sent by Developer API.                                          |
| Incoming Message | The Contact was added when an incoming message was received from the Contact the platform.                        |
| Echo Message     | The Contact was connected when his/her conversation was imported from the supported messaging channel (Facebook). |
| Zapier           | The Contact was connected via an outgoing message sent by Zapier action.                                          |
| Make             | The Contact was connected via an outgoing message sent by Make action.                                            |
| Broadcast        | The Contact was connected via an outgoing broadcast messages sent to the Contact successfully.                    |
| User             | The Contact was connected via an outgoing message sent by user from the Inbox module.                             |
| Click-to-Chat Ad | The Contact was connected when they clicked an advertisement.                                                     |

**Bar Chart**

The number of Contacts connected within the selected period by channel.

**Pie Chart**

The percentage and total number of Contacts connected within the selected period by channel.

### Logs

There are 4 logs available to view the Contact activities within the Workspace.

> Reports table has a limitation of generating a maximum of 10,000 row of results. If you need more data, consider using [Data Export](https://respond.io/help/workspace-settings/data-export).

#### Contact Added Log

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/tmqj9iULbw6bkv945WVvc/802754c2f43780c50c267450e80d12ae/contacts-added-lo.png?fm=jpg&q=80&w=640) 

Here is a log to view each Contact that was added to the Workspace.

Learn more about each column in the following table:

| Column Name    | Description                                                                                                                               |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Timestamp      | The date and time when the Contact was added.                                                                                             |
| Contact ID     | The ID of the Contact.                                                                                                                    |
| Contact Name   | The name of the Contact.                                                                                                                  |
| Source         | The source of creation of the Contact.                                                                                                    |
| Sub-source     | The Ad Sub-source of the Contact, shown as **Meta Click-to-Chat Ads** or **TikTok Messaging Ads**, if the Contact was added via Paid Ads. |
| Ad Campaign ID | The Ad Campaign ID from which the Contact originated.                                                                                     |
| Ad Group ID    | The ad group ID from which the Contact originated.                                                                                        |
| Ad ID          | The specific ad ID that the Contact interacted with.                                                                                      |
| User           | The name of the user who perform the action. Only applicable when the source is User.                                                     |

#### Contact Connected Log

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/7vwvcgZYKeiHtNAHv43rIG/21be99e6bddb9c65df41be3f11516d60/contacts-connected-lo.png?fm=jpg&q=80&w=640) 

Here is a log to view each Contact that was connected to your Workspace.

Learn more about each column in the following table:

| Column Name    | Description                                                                                                                                   |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Timestamp      | The date and time when the Contact was connected.                                                                                             |
| Contact ID     | The ID of the Contact.                                                                                                                        |
| Contact Name   | The name of the Contact.                                                                                                                      |
| Source         | The source of connection of the Contact.                                                                                                      |
| Sub-source     | The ad sub-source of the Contact, shown as **Meta Click-to-Chat Ads** or **TikTok Messaging Ads**, if the Contact was connected via Paid Ads. |
| Ad Campaign ID | The campaign ID from which the Contact originated.                                                                                            |
| Ad Group ID    | The ad group ID from which the Contact originated.                                                                                            |
| Ad ID          | The specific ad ID that the Contact interacted with.                                                                                          |
| User           | The name of the user who sent the outgoing message. Only applicable when the source is User.                                                  |

#### Contact Deleted Log

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2dPBksh0AnyM7DfXDbsvFh/f8220ca9f2420ad536e8386b9f3df69a/contacts-deleted-lo.png?fm=jpg&q=80&w=640) 

Here is a log to view each Contact that was deleted from your Workspace.

Learn more about each column in the following table:

| Column Name    | Description                                                                                                      |
| -------------- | ---------------------------------------------------------------------------------------------------------------- |
| Timestamp      | The date and time when the Contact was deleted.                                                                  |
| Contact ID     | The ID of the Contact deleted.                                                                                   |
| Contact Name   | The name of the Contact deleted.                                                                                 |
| Source         | The source of deletion of the Contact, which can only be User.                                                   |
| Sub-source     | If the Contact was initially added via Paid Ads, this shows the sub-source (Meta or TikTok) even after deletion. |
| Ad Campaign ID | The campaign ID tied to the deleted Contact, if available.                                                       |
| Ad Group ID    | The ad group ID tied to the deleted Contact, if available.                                                       |
| Ad ID          | The ad ID tied to the deleted Contact, if available.                                                             |
| User           | The name of the user who delete the Contact.                                                                     |

> If a user has been deleted from the Workspace, the username will be replaced with the user ID. Export all user IDs from User Settings before removing users for future username verification based on user ID.

#### Contact Merged Log

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/6a3jb1muG9fj4UGIzoBiHe/a67a41e86294b31d0f86a2cbd14f39ae/contacts-merged-lo.png?fm=jpg&q=80&w=640) 

Here is a log to view each Contact merge that happened.

Learn more about each column in the following table:

| Column Name        | Description                                                                           |
| ------------------ | ------------------------------------------------------------------------------------- |
| Timestamp          | The date and time when the Contact was merged.                                        |
| Primary Contact ID | The ID of the Contact after merging.                                                  |
| Contact Name       | The name of the Contact after merging.                                                |
| Source             | The source of Contact merging, which can only be User.                                |
| Sub-source         | If the merged Contact came from Paid Ads, this shows the sub-source (Meta or TikTok). |
| Ad Campaign ID     | The campaign ID of the merged Contact, if applicable.                                 |
| Ad Group ID        | The ad group ID of the merged Contact, if applicable.                                 |
| Ad ID              | The ad ID of the merged Contact, if applicable.                                       |
| User               | The name of the user who performed the Contact merging.                               |

Share this article

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/dashboard-reporting/reports-contacts)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/dashboard-reporting/reports-contacts)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/dashboard-reporting/reports-contacts)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/dashboard-reporting/reports-contacts)

## 

Related articles 👩‍💻

* [Reports: CallsTrack and analyze call performance across your Workspace. ](/help/dashboard-reporting/reports-calls)
* [Reports: Lifecycle Discover how Lifecycle Reports tracks leads from new to paying customers, measuring conversions, drop-offs, and time metrics for an optimized funnel. ](/help/dashboard-reporting/reports-lifecycle)
* [Reports: BroadcastsView the delivery rates of broadcasts to gain insights into the performance and delivery data of the broadcasts. ](/help/dashboard-reporting/reports-broadcasts)
* [Reports: UsersThe Users reports tab consists of all the metrics and information related to Users. ](/help/dashboard-reporting/reports-users)
* [Reports: LeaderboardInstantly identify and analyze top performing users and teams in the Workspace. ](/help/dashboard-reporting/reports-leaderboard)

Can't find what you're looking for? 🔎

[Contact Support](/contact-us)

2025-12-05T03:58:39.995Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"The Contacts reports tab consists of all the metrics and information related to Contacts.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4IHLTWbmWN0uXBc5x4jthC/59252fcdb357304ce07be76043047b7a/Susan_Swier_Avatar.svg","name":"Susan Swier","url":"https://respond.io/author/susan-swier"},"dateCreated":"2024-08-28T10:02:01.000Z","dateModified":"2025-05-29T06:42:41.058Z","datePublished":"2024-08-28T10:02:01.000Z","headline":"Reports: Contacts","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/2UsHd4FVVUF9osHczB8DZZ/658cc9e9c832a9b49e95a6f5c3269346/reports-filter.png","mainEntityOfPage":"https://respond.io/help/dashboard-reporting","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/2UsHd4FVVUF9osHczB8DZZ/658cc9e9c832a9b49e95a6f5c3269346/reports-filter.png","url":"https://respond.io/help/dashboard-reporting/reports-contacts"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/help","position":1},{"@type":"ListItem","name":"Product","item":"https://respond.io/help/product","position":2},{"@type":"ListItem","name":"Dashboard &amp; Reporting","item":"https://respond.io/help/dashboard-reporting","position":3},{"@type":"ListItem","name":"Reports: Contacts","item":"https://respond.io/help/dashboard-reporting/reports-contacts","position":4}]}]
```
