# Data Overview

Zoho Campaigns exposes a range of entities covering your contacts, mailing infrastructure, and campaign performance. Here's a breakdown of what each entity contains and how you can use it.

## Available entities

| Entity                | Best used for                                      |
| --------------------- | -------------------------------------------------- |
| Campaign reports      | Tracking opens, clicks, bounces per campaign       |
| Recent campaigns      | Getting a snapshot of newly created campaigns      |
| Recent sent campaigns | Monitoring delivery status of recently sent emails |
| Campaign details      | Deep-diving into individual campaign configuration |
| Campaign recipients   | Auditing who received a specific campaign          |
| Subscribers           | Analyzing your contact base and profile data       |
| Mailing lists         | Understanding list structure and segmentation      |
| Total contacts        | High-level contact count reporting                 |
| Topics                | Categorizing campaigns by subject matter           |
| All tags              | Reviewing your tagging taxonomy                    |

## Campaign performance metrics

#### Campaign reports

| Field           | Description                            |
| --------------- | -------------------------------------- |
| Campaign name   | Name of the email campaign             |
| Sent count      | Total number of emails sent            |
| Delivered count | Emails successfully delivered          |
| Opens           | Total number of email opens            |
| Unique opens    | Distinct recipients who opened         |
| Clicks          | Total link clicks                      |
| Unique clicks   | Distinct recipients who clicked        |
| Bounces         | Total bounced emails                   |
| Hard bounces    | Permanent delivery failures            |
| Soft bounces    | Temporary delivery failures            |
| Unsubscribes    | Recipients who opted out               |
| Spam complaints | Emails marked as spam                  |
| Open rate       | Percentage of delivered emails opened  |
| Click rate      | Percentage of delivered emails clicked |

#### Campaign details

| Field          | Description                                   |
| -------------- | --------------------------------------------- |
| Campaign ID    | Unique identifier for the campaign            |
| Campaign name  | Display name                                  |
| Subject line   | Email subject                                 |
| From name      | Sender name                                   |
| From email     | Sender email address                          |
| Status         | Draft, scheduled, or sent                     |
| Created time   | When the campaign was created                 |
| Scheduled time | When the campaign was or is scheduled to send |

## Contact and list data

#### Subscribers

| Field         | Description                             |
| ------------- | --------------------------------------- |
| Email address | Subscriber's email                      |
| First name    | Subscriber's first name                 |
| Last name     | Subscriber's last name                  |
| Signup date   | When they subscribed                    |
| Status        | Active, unsubscribed, bounced           |
| Source        | How they were added (import, form, API) |

#### Mailing lists

| Field            | Description                           |
| ---------------- | ------------------------------------- |
| List name        | Name of the mailing list              |
| List ID          | Unique identifier                     |
| Subscriber count | Number of active contacts in the list |
| Created date     | When the list was created             |

#### Campaign recipients

| Field         | Description              |
| ------------- | ------------------------ |
| Email address | Recipient's email        |
| Campaign name | Campaign they received   |
| Delivery time | Timestamp of delivery    |
| Status        | Delivered, bounced, etc. |

## Common metric combinations

* **Campaign reports + Campaign details** — Join on Campaign ID to get performance metrics alongside subject lines and sender info in one table
* **Subscribers + Mailing lists** — Understand which lists your contacts belong to and how lists are growing over time
* **Campaign recipients + Campaign reports** — Correlate individual delivery records with overall campaign-level stats
* **Recent sent campaigns + Campaign reports** — Use Append to build a rolling history of sent campaigns with their performance data

## Use cases by role

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

* Track open rates and click rates across campaigns to identify your best-performing subject lines
* Monitor unsubscribe and bounce rates to maintain list health
* Use Aggregate transformation to roll up metrics by topic or tag, giving you category-level performance views
* Export to Looker Studio or Google Sheets for shareable campaign performance dashboards
  {% endtab %}

{% tab title="Marketing ops" %}

* Join campaign reports with CRM data to connect email engagement to pipeline outcomes
* Use Append to combine data from multiple Zoho Campaigns accounts into a single destination
* Feed subscriber and campaign data into BigQuery for SQL-based analysis and historical trend tracking
* Pipe campaign data into Claude or ChatGPT to auto-generate performance summaries for stakeholders
  {% endtab %}

{% tab title="Growth teams" %}

* Analyze list growth over time using Subscribers and Total contacts data
* Identify engaged segments by filtering subscribers with high open or click history
* Use topics and tags to segment campaign performance by content category or audience type
  {% endtab %}
  {% endtabs %}

## Platform-specific notes

* Zoho Campaigns API keys are scoped to the account — make sure the key belongs to a user with access to all lists and campaigns you need
* The **Recent campaigns** and **Recent sent campaigns** entities return a limited window of campaigns — use **Campaign details** if you need data on older campaigns by ID
* Contact status values (active, unsubscribed, bounced) reflect the state at the time of sync, not historical state changes
* Tags and topics are organization-level metadata — useful for filtering in your destination but not tied to performance metrics directly