Skip to main content

​
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

​
Rate Limits & Production Notes

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