Blog → Brand Voice

Pull published blog posts from HubSpot CMS and create a Mavera Brand Voice profile for future content generation

Scenario

Your 50+ published blog posts represent your established voice. Instead of writing a brand guide manually, you pull blog URLs from HubSpot CMS, pass them into Mavera’s Brand Voice endpoint, and get a voice profile for all future content generation.

Architecture

Code

Python

import os, requests, time
from openai import OpenAI

HS = os.environ["HUBSPOT_ACCESS_TOKEN"]
MV = os.environ["MAVERA_API_KEY"]
MB = "https://app.mavera.io/api/v1"

# 1. Published blog posts
posts = requests.get("https://api.hubapi.com/cms/v3/blogs/posts",
    headers={"Authorization": f"Bearer {HS}"},
    params={"state": "PUBLISHED", "sort": "-publishDate", "limit": 30,
            "property": "name,url,postSummary,postBody"},
).json().get("results", [])

urls = [p["url"] for p in posts if p.get("url")]
samples = [f"Title: {p.get('name','')}\n{p.get('postSummary','') or p.get('postBody','')[:500]}"
           for p in posts if p.get("postSummary") or p.get("postBody")]

# 2. Create Brand Voice
payload = {"name": "HubSpot Blog Voice", "urls": urls[:15]}
if samples:
    payload["samples"] = ["\n\n---\n\n".join(samples[:10])]

bv = requests.post(f"{MB}/brand-voices",
    headers={"Authorization": f"Bearer {MV}", "Content-Type": "application/json"},
    json=payload).json()
print(f"Brand Voice: {bv['id']}")

# 3. Verify status
time.sleep(3)
detail = requests.get(f"{MB}/brand-voices/{bv['id']}",
    headers={"Authorization": f"Bearer {MV}"}).json()
print(f"Status: {detail.get('status','unknown')}")

# 4. Test generation
mavera = OpenAI(api_key=MV, base_url=MB)
test = mavera.responses.create(model="mavera-1",
    input=[{"role": "user", "content": "Write a 100-word blog intro about AI in marketing."}],
    extra_body={"brand_voice_id": bv["id"]})
print(f"\n{test.output[0].content[0].text}")

const OpenAI = require("openai").default;
const HS = process.env.HUBSPOT_ACCESS_TOKEN;
const MV = process.env.MAVERA_API_KEY;
const MB = "https://app.mavera.io/api/v1";

// 1. Published blog posts
const posts = await fetch(`https://api.hubapi.com/cms/v3/blogs/posts?state=PUBLISHED&sort=-publishDate&limit=30&property=name,url,postSummary,postBody`,
  { headers: { Authorization: `Bearer ${HS}` } }).then(r => r.json()).then(d => d.results || []);

const urls = posts.map(p => p.url).filter(Boolean);
const samples = posts.filter(p => p.postSummary || p.postBody)
  .map(p => `Title: ${p.name}\n${p.postSummary || (p.postBody || "").slice(0, 500)}`);

// 2. Brand Voice
const payload = { name: "HubSpot Blog Voice", urls: urls.slice(0, 15) };
if (samples.length) payload.samples = [samples.slice(0, 10).join("\n\n---\n\n")];
const bv = await fetch(`${MB}/brand-voices`, {
  method: "POST",
  headers: { Authorization: `Bearer ${MV}`, "Content-Type": "application/json" },
  body: JSON.stringify(payload),
}).then(r => r.json());
console.log(`Brand Voice: ${bv.id}`);

// 3. Test generation
await new Promise(r => setTimeout(r, 3000));
const mavera = new OpenAI({ apiKey: MV, baseURL: MB });
const test = await mavera.responses.create({
  model: "mavera-1",
  input: [{ role: "user", content: "Write a 100-word blog intro about AI in marketing." }],
  extra_body: { brand_voice_id: bv.id },
});
console.log(test.output[0].content[0].text);

Example Output

Brand Voice: bv_blog_8k2m (status: ready)

AI isn't coming for your marketing job — it's coming for the busywork that
keeps you from doing it well. We've seen teams go from 60% reporting to 60%
strategy. That's not marginal — it's fundamental. Here's what we're seeing.

Error Handling

CMS scope required

Blogs endpoint needs content scope. Add in HubSpot Settings → Private Apps → Scopes if you get 403.

Password-protected blogs

Mavera can’t crawl protected pages. Pass postBody HTML as samples text instead of URLs.

---

HubSpot Integration

Brand Voice API