Integrating Zoy with Your Existing CRM Stack
For growth-stage founders and B2B marketers, the CRM is the backbone of every deal. You have the leads, the contact history, and the deal stages. But turning that data into a consistent marketing presence usually requires a team you haven't hired yet. The gap between having organized lead data and actually using it for personalized outreach is where most growth stalls.
Zoy bridges that gap with a direct, two-way integration with HubSpot. Instead of manually exporting lists or rebuilding lead context in a separate tool, Zoy syncs directly with your HubSpot contacts. Your prospect data flows into Zoy's content and outreach engine, and lifecycle changes are reflected back in HubSpot — ensuring both systems stay in sync.
In this guide, you will learn how the HubSpot integration works under the hood, exactly which data flows between systems, and how to connect your account to start using your CRM data for smarter content and outreach.
TL;DR: Zoy connects to HubSpot via the CRM v3 API, enabling two-way sync between your HubSpot contacts and Zoy's prospect database. Lifecycle stages, contact details, and industry data flow between both systems so your marketing and sales stay aligned.
What is CRM Integration in Zoy?
CRM integration in Zoy is the process of connecting your HubSpot account to Zoy's marketing engine via a private app access token. Once connected, Zoy can read your HubSpot contacts, create new ones from its prospect database, and keep lifecycle stages synchronized. This allows your AI-driven content and outreach to work with real lead data instead of operating in a vacuum.
Why HubSpot Integration Matters for Your Marketing
Most companies treat their CRM and their marketing tools as two separate worlds. Lead data sits in HubSpot while blog content gets written from generic best practices. When Zoy is connected to HubSpot, it can use actual prospect information — industry, pain points, intent scores — to generate content and outreach that resonates with your real audience.
Keeping Prospect Data in Sync
Without integration, you end up maintaining two separate databases. A lead's status changes in HubSpot, but your outreach tool doesn't know. Zoy's two-way sync eliminates this: when a prospect moves from "new" to "qualified" in Zoy, the lifecycle stage in HubSpot is updated accordingly. When a contact is updated in HubSpot, that data can be pulled back into Zoy.
Enriching Content with Real Customer Context
Zoy uses prospect data — including industry vertical, ICP match scores, and intent signals — to inform its content generation. Instead of writing generic posts, the content engine understands who your actual audience is and tailors topics and messaging to match their challenges and goals.
How the Integration Works
Zoy uses the HubSpot CRM v3 API to maintain a bidirectional connection between your HubSpot contacts and Zoy's prospect records.
Data That Flows from Zoy to HubSpot
When Zoy syncs a prospect to HubSpot, the following fields are mapped:
| Zoy Prospect Field | HubSpot Contact Property | Notes |
|---|---|---|
| Contact email | email | Required, used as unique key |
| Contact name | firstname / lastname | Auto-split from full name |
| Company name | company | Organization name |
| Job title | jobtitle | Contact's role |
| Phone | phone | Contact phone number |
| Industry | industry | Vertical classification |
| Status | lifecyclestage | Mapped to HubSpot stages |
Lifecycle Stage Mapping
Zoy maps its internal prospect statuses to HubSpot lifecycle stages:
| Zoy Status | HubSpot Lifecycle Stage |
|---|---|
| New | Subscriber |
| Contacted | Lead |
| Qualified | Marketing Qualified Lead |
| Opportunity | Sales Qualified Lead |
| Customer | Customer |
This means when Zoy's outreach engine qualifies a lead through engagement, HubSpot reflects that change automatically.
Data That Flows from HubSpot to Zoy
Zoy can also pull contacts from HubSpot into its prospect database. When a HubSpot contact is synced to Zoy, the system creates or updates a local prospect with the contact's details, making that lead available for outreach sequences and content personalization.
Step-by-Step: Connecting Zoy to HubSpot
The integration uses a HubSpot private app access token. Here's how to set it up:
1. Create a HubSpot Private App
In your HubSpot account, navigate to Settings → Integrations → Private Apps. Create a new private app and grant it the following scopes:
crm.objects.contacts.readcrm.objects.contacts.write
Copy the generated access token.
2. Add Your API Key in Zoy
In your Zoy dashboard, go to Settings and enter your HubSpot private app access token. Zoy stores this securely and uses it for all CRM API calls. Each tenant connects their own HubSpot account — your data is never shared across accounts.
3. Start the Sync
Once configured, Zoy will automatically:
- Search HubSpot by email before creating duplicate contacts
- Create new HubSpot contacts from Zoy prospects that don't exist yet
- Update existing contacts when prospect data changes in Zoy
- Pull HubSpot contact data into Zoy when you trigger an inbound sync
4. Let Content and Outreach Leverage the Data
With contacts synced, Zoy's content engine uses prospect pain points, industries, and goals to generate blog posts and outreach sequences that reflect your actual customer base — not hypothetical personas.
What Zoy Does with Your CRM Data
The integration isn't just about keeping databases in sync. Here's how Zoy uses the connected data:
Content Generation
Zoy's blog posting agent uses customer pain points and goals extracted from your prospect data to generate relevant content. If your HubSpot contacts are predominantly in the FinTech space, the content engine uses that industry context when crafting posts aligned to your content strategy pillars.
Outreach Sequences
Zoy's outreach engine — which supports email, LinkedIn, and SMS channels — uses synced prospect data to personalize messages. A prospect's company, title, and industry inform the tone and content of each touchpoint in a sequence.
Brand Voice Alignment
During onboarding, Zoy crawls your website to extract your brand voice — tone, key phrases, and style characteristics. This brand voice is combined with CRM-sourced audience data to ensure generated content sounds like your team wrote it, for the people your team actually sells to.
Comparison: With and Without CRM Integration
| Capability | Without Integration | With HubSpot Connected |
|---|---|---|
| Content personalization | Based on general industry keywords | Based on real prospect industries and pain points |
| Lead status | Managed separately in each tool | Synced lifecycle stages |
| Outreach context | Generic templates | Personalized with CRM contact details |
| Duplicate management | Manual checks | Email-based search before contact creation |
| Data freshness | Point-in-time exports | Synced on each operation |
Frequently Asked Questions (FAQ)
Does Zoy require a developer to set up the HubSpot integration?
No. You need to create a HubSpot private app (a few clicks in HubSpot settings) and paste the access token into Zoy. No custom code or webhooks required.
Will Zoy overwrite my existing HubSpot data?
Zoy searches by email before creating contacts, so it won't create duplicates. When updating existing contacts, it only writes the fields listed in the mapping table above. Your custom properties and other HubSpot data remain untouched.
What about Salesforce?
Salesforce integration is on our roadmap. The architecture is built to support multiple CRM providers — the same interface used for HubSpot can be extended to Salesforce, Pipedrive, and other platforms. Stay tuned for updates.
What CRM data does Zoy use for content?
Zoy uses aggregated prospect data — primarily industry verticals, pain points, and goals — to inform content topics and strategy. Individual contact details are used for outreach personalization, not for blog content.
Is my HubSpot data secure?
Each tenant's HubSpot API key is stored separately and used only for that tenant's operations. Zoy uses HTTPS for all HubSpot API calls, and your token can be revoked from HubSpot at any time.
Key Takeaways
- Two-Way Sync: Prospects in Zoy and contacts in HubSpot stay aligned with automatic lifecycle stage mapping.
- Real Data, Better Content: Your CRM's industry and pain point data feeds directly into Zoy's content generation engine.
- No Duplicates: Zoy searches by email before creating contacts, preventing duplicate records in your CRM.
- Tenant Isolation: Each account connects their own HubSpot instance — your data stays yours.
What to Do Next
If your CRM data is sitting idle while you write marketing content from scratch, it's time to connect the two. Add your HubSpot API key in Zoy's settings and let your prospect data power your content and outreach engine.