Skip to main content
Brew supports multiple brands inside a single account. Useful if you’re running:
  • A parent company plus subsidiaries
  • An agency working across client brands
  • A multi-product business with distinct brand identities
  • A white-label setup
Each brand has its own colors, fonts, voice, sending domain, audience, automations, and analytics. Switching brands updates the entire app: sidebar, canvas, audience table, automations dashboard. You only ever see data for the active brand.

​
How Brand Switching Works

Click the brand pill at the top of the sidebar to switch. Every page that shows brand-specific data (which is most of them) instantly re-scopes. Everything below is brand-scoped:
  • Brand identity, email-design.md, image-style.md, and assets
  • Emails on the canvas
  • Audiences and contacts
  • Automations and triggers
  • Analytics
  • Domains and their unsubscribe lists
  • Connected integrations
  • API keys bound to the brand
These are not brand-scoped:
  • Your account (the same in every brand)
  • Your team (organization-level)
  • Organization API keys
  • Your plan, credits, and billing

​
API Keys and Agent Connections

An API key works for one brand or for your whole organization. A brand key, including the default key Brew issues when a brand finishes extraction, only reaches its own brand. An organization key reaches every brand, and each request names the brand it acts on. Organization admins create either kind from Settings → API. Authentication owns the key lifecycle and scoping rules. MCP connections work the same way: when you connect an agent, it covers one brand or the whole organization. See MCP Authentication & Scoping.

​
Adding a Brand

Click the brand pill in the sidebar and choose Add brand. The brand-setup dialog opens. Enter the new brand’s domain and Brew runs extraction. Once it completes, the new brand is available in the switcher. From an agent or code, create_brand over MCP or POST /v1/brands starts the same extraction:
  • Access. Both need an organization-wide connection or key. A key also needs the brands permission, which emails doesn’t include.
  • Readiness. Poll get_brand_status (or GET /v1/brands/{brandId}) until the brand is ready, typically 1 to 3 minutes.
  • Cost. Extraction isn’t charged, but your organization needs a credit balance to start one.
  • Limits. A brand over your plan’s limit is refused with 402 BRAND_LIMIT_REACHED.
Only one extraction can run at a time per organization. If a brand is mid-extraction, the dialog opens to its progress view rather than letting you start a new one.

​
Plans and Brand Limits

Every plan includes multiple brand workspaces. The count scales with the plan: see Plans and Limits for the current numbers per tier.

​
At Your Plan’s Limit

If adding a brand would pass your plan’s workspace count, you have two options. Upgrade from Billing & Usage (click your credits balance in the sidebar), and new workspaces become available right away. Or delete a brand you no longer use. Switch to it, open Brand, and click Delete brand at the bottom of Details. Only organization admins see it.
Deleting a brand is permanent. Everything brand-scoped, as listed under How Brand Switching Works, is removed with it. Export anything you want to keep first. Emails already sent aren’t affected.

​
Need Help?

Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:

Search Documentation

Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.

Ask ChatGPT or Claude

Click here to open the Copy page menu at the top of this page, then send the page to ChatGPT, Claude, or your editor.