- A parent company plus subsidiaries
- An agency working across client brands
- A multi-product business with distinct brand identities
- A white-label setup
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. A few examples of what’s brand-scoped:- Emails on the canvas
- Audiences and contacts
- Automations
- Analytics
- Domains
- Connected integrations
- Your account (you’re the same user)
- Your team (organization-level)
API Key and MCP Scopes
API keys come in two scopes, chosen when you create the key in Settings → API. A brand-scoped key carries the org and one brand, and works only for that brand. It is a good fit for a per-brand integration you want firmly fenced. An organization-scoped key (“All brands”) reaches every brand in the org, including ones created later, and names the brand on each brand-scoped request. In the SDK that isbrew.withBrand(brandId); over raw HTTP it is the X-Brand-Id header. It can also create brands, which a brand-scoped key cannot. There is no default brand: a request that names none is rejected rather than guessed. Only organization admins can create or revoke organization-scoped keys.
MCP connections work the same way: choose one brand, or choose “All brands” as an organization admin. Both connection types can call list_brands and get_brand_status; a brand connection sees only its bound brand. An organization connection can also call create_brand, then passes brand_id to brand-scoped tools. See API configuration.
The default key issued when a brand finishes onboarding follows the same rule. Deleting and re-extracting a brand, or adding another one, runs onboarding again and issues a new default key scoped to that brand.
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.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
Multiple brands are a Pro+ feature. The exact brand count per plan and the price-per-additional-brand live on the pricing page.On the Basic Plans
If you’re on the free or starter plan and want to add a different brand, delete the existing brand first, then add the new one. You can do this from the Brand tab. Open the brand you want to remove and click Delete brand. This is useful if your business has rebranded or you want to switch which brand Brew is set up for. Note that deleting a brand removes its emails, audiences, automations, and analytics. Export anything you want to keep first.Switching Plans to Add Brands
Upgrade from the Pricing page or from Settings → Usage in the app. New brands become available immediately after upgrading.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:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
ChatGPT/Claude Integration
Click “Open in ChatGPT” at the top right of any page to analyze documentation with ChatGPT or Claude for deeper insights.