HubSpot

Integrate Mavera with HubSpot — lifecycle personas, deal replay, meeting analysis, form analysis, blog brand voice, and engagement-weighted refinement

Overview

Pull data from HubSpot (Contacts, Deals, Emails, Meetings, Companies, Forms, Blog) → analyze with Mavera (Personas, Brand Voice, Focus Groups, Mave, Chat, Generate) → get persona-validated insights for marketing, sales, and product teams.

HubSpot API — Base URL: https://api.hubapi.com/crm/v3/. Auth: Private App access tokens or OAuth 2.0. Rate limits: 100–250 req/10s burst; CRM Search: 4 req/sec.

---

Prerequisites

1. HubSpot access token

   Create a Private App with scopes: crm.objects.contacts.read, crm.objects.deals.read, crm.objects.companies.read, content, forms, sales-email-read.
2. Mavera API key

   Get your key from Mavera dashboard.
3. Environment variables

   export HUBSPOT_ACCESS_TOKEN="pat-na1-xxxxx" and export MAVERA_API_KEY="mvra_live_xxxxx"

---

Jobs

#	Job	HubSpot Data	Mavera Surface	Output
1	Lifecycle Stage Persona Builder	Contact search by stage	Custom Personas	Funnel-stage persona set
2	Deal-Closed Content Replay	Closed Won + emails	Brand Voice + Generate	Email content from winners
3	Contact Property → Focus Group	Custom properties	Personas + Focus Group	Segment feedback
4	Meeting Notes → Mave Research	Meeting notes	Mave Agent	Pattern analysis
5	Company Enrichment + Personas	Companies	Mave + Personas	ABM buying committee
6	Form Submission Analysis	Form responses	Chat with persona	Structured categorization
7	Blog → Brand Voice	Published posts	Brand Voice (URL)	Voice from blog
8	Engagement-Weighted Refinement	Engagement data	Personas (update)	Evolved personas

---

Rate Limits & Production Notes

HubSpot Endpoint	Limit	Strategy
CRM Search	4 req/sec	250ms delay; retry on 429
CRM Read / Associations	100 req/10s	Batch where possible
Forms / CMS Content	100 req/10s	Paginate with after; cache locally

CRM Search is the strictest at 4 req/sec. All code includes 429-retry logic. For production, implement a token-bucket rate limiter or use HubSpot’s batch APIs.

Checklist: Secure credentials in env vars or secrets manager. Handle pagination via after cursor (max 100 per page). Retry with exponential backoff on 429/5xx. Monitor Mavera credits at Dashboard. Cache HubSpot data for daily jobs; use webhooks for real-time.

---

All Integrations

HubSpot API

Personas

Focus Groups

Brand Voice

Mave Agent