Home / Integrations / HubSpot
Native integration · live OAuth install · 90 seconds All hubs · down to Starter

Mama plugs into HubSpot with one OAuth click and four custom properties.

OAuth in 90 seconds. Read-only by default — we pull your Company list and write nothing until you opt in. Once write-back is on, the score, brief, and signals land on the Company object via four custom properties, visible everywhere a HubSpot user already works.

OAuth · 2.0
Reads Company, Contact, Deal
Writes 4 custom properties, opt-in
Sync cadence Every 6 hours
API quota use Batch API · < 1% daily
Tiers Starter, Pro, Enterprise
What Mama writes back

Four custom properties, all on the Company object.

No HubDB tables, no custom objects, no workflow build required. Mama creates four custom Company properties with your admin's approval at install. Reps see them on the Company record sidebar; ops builds lists and workflows off them like any other property.

Always on
Mama Score
Integer 0–100 from the ICP rubric. Updates every 6 hours. Use in HubSpot lists, workflows, and reports like any built-in property.
Property:mama_score · Number
Opt-in
Brief Summary
4-line synthesis of why the account is scored what it is. Refreshed when the score moves >10 points. Renders cleanly in the Company sidebar; full brief one click away.
Property:mama_brief_summary · Multi-line text
Opt-in
Last Signal Date
Timestamp of the most recent signal Mama detected. Triggers HubSpot workflows — auto-route fresh accounts to the rep on call, or pause sequences when nothing has fired in 60+ days.
Property:mama_last_signal · Date picker (timestamp)
Opt-in
Brief Link
URL to the full brief in Mama. One-click from the HubSpot record into the rep's working surface. Renders as a hyperlink in sidebar + sequence tokens.
Property:mama_brief_url · Single-line text (URL)
Install in 5 steps

90 seconds from click "Connect" to first scoring run.

No marketplace install, no certified-developer signoff, no workflow build required. Standard OAuth + a few clicks in HubSpot. Your security team can audit every step before they approve.

1
Click "Connect HubSpot" in Mama
From your workspace settings. Pick your portal (production or sandbox).
~ 5 sec
2
HubSpot OAuth screen
Standard HubSpot login. Approve the read scopes we request (crm.objects.companies, contacts, deals).
~ 30 sec
3
Pick what to score
Choose a saved HubSpot list or "all companies." Filter by property if you want a narrower scope.
~ 15 sec
4
Opt in to write-back (optional)
If yes, Mama creates the 4 custom properties automatically. If no, we score read-only.
~ 10 sec
5
First scoring run
Mama pulls every Company that matches your filter. First brief lands in your inbox ~3 min later.
~ 3 min
What's supported, what's not

The honest list of what we do and don't.

All true as of the latest /changelog entry. If something on the "doesn't" list matters to you, email [email protected] — most missing things are on the roadmap.

Mama does
All HubSpot CRM tiers — Starter, Pro, Enterprise. Free tier of HubSpot also works.
All hubs — Marketing, Sales, Service, CMS, Operations. We read the CRM core objects only, no hub-specific deps.
Saved lists as the source — pick any active or static list in your portal to scope what Mama scores.
Sandbox portals — install on a sandbox first, promote to production with one config change.
Bulk API for writes — efficient quota use, doesn't compete with marketing automation calls.
Property visibility controls — admin can scope which user groups see the Mama properties via standard HubSpot permissions.
Workflow triggers off Mama properties — auto-enrollment, sequence pauses, lead-routing rules can all read mama_score and mama_last_signal.
Mama doesn't (yet)
Custom objects. We score the Company object only. If your buyer-fit object is a custom HubSpot object, ping us — it's on the roadmap.
Contact-level scoring. Mama scores Companies. The contact list is read so we can suggest which contacts to talk to, but contacts themselves don't get an individual score.
Marketing Hub write-back into properties beyond the 4. Some teams want score-by-dimension as separate fields — coming Q2 2026.
Webhooks to trigger Mama from HubSpot (the reverse direction). One-way sync only today.
Real-time score push. Sync is every 6 hours. Webhook-on-change is on the Pro tier roadmap.
Multi-portal under one workspace. Each Mama workspace connects to one HubSpot portal. Consultancies use one Mama workspace per client portal — that's the supported pattern.
Your HubSpot data never leaves your Mama workspace. OAuth-scoped, AES-256 at rest, TLS 1.3 in transit, never used for training. SOC 2 Type II report under NDA. You can revoke Mama's OAuth grant from HubSpot Settings → Integrations any time — sync stops within the next cycle.
AES-256 TLS 1.3 OAuth 2.0 SOC 2 II (NDA)
Full security posture →
HubSpot-specific FAQ

The questions HubSpot admins ask on the first call.

Pulled from real evaluation conversations with launch partners running HubSpot. If your question isn't here, email [email protected] and we'll add it to this page next.

Do you need to be installed from the HubSpot marketplace?
No. Mama installs as a private OAuth app on your portal — same security model as any Connected App. No marketplace listing dependency. The 4 custom properties are created via the standard CRM API with your admin's approval at install.
What scopes do you request?
Read scopes: crm.objects.companies.read, crm.objects.contacts.read, crm.objects.deals.read. Write (opt-in): crm.schemas.companies.write for the property creation, then crm.objects.companies.write for ongoing updates.
How does this affect our API quota?
Mama uses the Batch API for reads and writes. A 10,000-company portal consumes ~8 batch calls per day — well under typical 250k-daily quotas. Full breakdown available in our security doc.
Can I install on a HubSpot sandbox portal first?
Yes — recommended for portals over 10k companies. One config change to promote from sandbox to production. The OAuth app is the same; only the portal ID changes.
What happens if I revoke the OAuth grant?
Sync stops within the next 6-hour cycle. The 4 custom properties remain on your Company records with their last-written values — nothing gets deleted. You can re-install any time and pick up where you left off.
Does this work with HubSpot Sequences?
Yes — the Brief URL property renders as a clickable token in sequence steps. Reps click through from a cadence touch into the full brief. Score and Last Signal are usable in sequence enrollment criteria + branch conditions.
90 seconds to install

Connect your HubSpot portal and see every company scored by tomorrow morning.

Free up to 100 companies. No credit card. Read-only by default — your IT team can audit every scope we ask for before they approve.