Brand Kit Management
Configure brand colors, logos, typography, and voice — or extract them automatically from your website.
Brand Kit Management
Every Templated account has a brand kit that defines the visual identity and voice used across templates and AI generation. The brand kit ensures all emails are on-brand.
Get the brand kit
curl -b cookies.txt \
https://app.templated.email/api/accounts/{slug}/brand-kitReturns { "brandKit": { ... } } with the fields below.
Update the brand kit
curl -b cookies.txt -X PUT \
https://app.templated.email/api/accounts/{slug}/brand-kit \
-H "Content-Type: application/json" \
-d '{
"primaryColor": "#F97066",
"secondaryColor": "#F59E0B",
"logoUrl": "https://cdn.templated.email/logos/acme.png",
"logoPlacement": "top",
"fontHeading": "Sora",
"fontBody": "Inter",
"tone": "professional",
"industry": "SaaS",
"companyDescription": "Project management for distributed teams.",
"stylePreference": "modern",
"defaultCtaStyle": "solid"
}'All fields are optional and nullable — send only what you want to change. Requires admin permissions.
Brand kit fields
| Field | Type | Description |
|---|---|---|
primaryColor / secondaryColor / accentColor | string | 6-digit hex colors (e.g. #F97066) |
logoUrl | string | URL to your logo, max 512 chars |
logoPlacement | enum | top, bottom, or none |
fontHeading / fontBody | string | Font family names, max 100 chars |
tone | enum | Brand voice: professional, casual, playful, bold, or minimal |
industry | string | Your industry, max 100 chars |
companyDescription | string | What your company does, max 2000 chars — feeds AI copywriting |
stylePreference | enum | Visual style: modern, classic, bold, minimal, or playful |
defaultCtaStyle | enum | Default button variant: solid or outline |
Extract from a website
Pro and Business plans can auto-populate the brand kit from a website — the extractor pulls colors, fonts, and the logo (re-hosted to Templated's CDN so emails never hotlink your site):
curl -b cookies.txt -X POST \
https://app.templated.email/api/accounts/{slug}/brand-kit/extract \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com" }'Returns { "data": { ...extracted fields } }. Review the result and save it with the update endpoint above — extraction does not write the brand kit itself.
| Status | Meaning |
|---|---|
403 | Free plan (code: PLAN_REQUIRED) or missing account:settings:edit permission |
422 | The website couldn't be reached (code: FETCH_FAILED) |
429 | Rate limited — extraction triggers outbound fetches, so it's throttled per account |
How the brand kit is used
AI generation
When you generate a template with AI, the brand kit provides the color palette, logo placement, fonts, and — via tone, industry, and companyDescription — the voice of the copy.
Template defaults
New templates created in the editor inherit brand kit colors and fonts as defaults.
Custom fonts
For custom font management (uploading, listing, deleting fonts), see the Managing Fonts guide.
Next steps
- Upload custom fonts for unique typography
- Generate AI templates using your brand kit
- Test endpoints in the API Reference