Beam Help
Get help now

How-to · Zoho CRM

How to retrieve a campaign in Zoho CRM

Access campaign details and performance data for your marketing efforts.

Retrieving a campaign in Zoho CRM involves navigating the Campaigns module and using the CRM–Campaigns integration to surface the right records. Here at Beam Help — independent expert support for Zoho, not official Zoho support — we walk you through the exact steps below.


Why this matters


If your sales team needs visibility into which marketing campaigns are influencing pipeline, you must be able to locate and review campaign records directly inside Zoho CRM. This is also essential when troubleshooting sync issues, checking bounce data, or verifying that campaign fields are correctly mapped between Zoho Campaigns and Zoho CRM. Without knowing how to retrieve a campaign record, you cannot act on the data it contains. [1][6]


Step-by-step


Step 1. Confirm that the Zoho Campaigns integration with Zoho CRM is active. Log in to Zoho Campaigns, navigate to Settings, and verify the CRM integration status. If the integration is not connected, campaign data will not flow into CRM and no campaign records will be retrievable from the CRM side. [6]


Step 2. Log in to your Zoho CRM account. In the top navigation bar, look for the Campaigns module. Depending on your CRM edition and customisation, this module may appear in the main navigation or under the More (⋯) overflow menu. Click it to open the Campaigns list view. [1]


Step 3. In the Campaigns list view, use the search bar or the available filter options to locate the specific campaign you need. You can filter by campaign name, status, or date range to narrow down results quickly. [1]


Step 4. Click the campaign name to open the campaign detail record. From this detail view you can review associated contacts, leads, and any synced activity data that has been pushed from Zoho Campaigns into CRM. [1][6]


Step 5. If you need to display additional Campaigns fields within the CRM record — for example, a custom field from Zoho Campaigns — you must add that field to the corresponding CRM module layout. Navigate to CRM Settings → Modules and Fields, select the relevant module (e.g., Leads or Contacts), and add the Campaigns field to the standard layout so it becomes visible on the record. [6]


Step 6. If you are working with the Zoho Campaigns API and need to retrieve campaign details programmatically, you will need both an API authentication token and a campaign key. The campaign key is a unique identifier for each campaign and is required as a parameter when calling the campaign details endpoint. To obtain the campaign key, open the campaign inside Zoho Campaigns — the key is typically surfaced in the campaign's settings or URL. [2]


Step 7. Once you have retrieved the campaign record, check whether the sync between Zoho Campaigns and Zoho CRM is pushing reports correctly. Navigate to Campaign to CRM sync settings inside Zoho Campaigns to confirm that push reports are enabled and that opt-out and bounce data are flowing back to CRM as expected. [6]


Common pitfalls


  • CRM owner address disabled in campaign sender settings: If the CRM owner address option is greyed out when personalising sender details in Zoho Campaigns, it almost always means the CRM integration is either not set up or has become disconnected. Re-integrating Zoho CRM with Zoho Campaigns resolves this. [8]

  • Sender email not fetched from a custom field: When using a custom field to drive the sender address in a campaign, the email address stored in that field must be verified inside Zoho Campaigns first. Unverified addresses are silently skipped, which can make it appear as though the campaign configuration is broken. [8]

  • Newly mapped CRM fields not appearing immediately: After you add a new field to the CRM–Campaigns field mapping, it will only be pulled in during the next scheduled fetch cycle. If you need the data right away, create a one-time sync with the same criteria as your periodic sync and include the new field in the mapping — this forces an immediate update to your mailing list without waiting for the next cycle. [6]

  • Deleted CRM contacts not removed from mailing lists: If contacts deleted from Zoho CRM are still appearing in your Campaigns mailing lists, check the Campaign to CRM sync settings for the relevant configuration option. Note that accounts using the newer CRM integration model handle deleted contacts automatically by default. [6]

  • No eligible contacts error when sending: If you see a message stating a campaign cannot be sent because there are no eligible contacts in the selected mailing list, verify that the mailing list actually contains active, non-opted-out contacts before attempting to retrieve or resend the campaign. [2]

What to check


  • Integration status: Confirm the Zoho CRM ↔ Zoho Campaigns integration is active and healthy before expecting campaign records to appear in CRM. [6]
  • Module layout: Verify that the Campaigns module is visible in your CRM navigation and that any custom Campaigns fields you need have been added to the relevant module layout. [6]
  • Sync configuration: After retrieving a campaign, review the push-reports and opt-out sync settings to ensure campaign engagement data is flowing back into CRM correctly. [6]

Sources cited

  1. [1] Campaigns | Integrate With Zoho CRM | Knowledge Base
  2. [2] Zoho Community | Connect, network, and share on Zoho Forums
  3. [3] المشكلة الحقيقية: البيانات موجودة، لكن مشتتة
  4. [4] Create your first email campaign - Online Help | Zoho Campaigns
  5. [5] Remove Bounced email addresses from CRM after running a campaign
  6. [6] Zoho CRM Sync - Troubleshooting Guide
  7. [7] Campanha no CRM
  8. [8] Campaign creation flow - Troubleshooting Guide
Get Campaign in Zoho CRM | Beam Help