Templated

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-kit

Returns { "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

FieldTypeDescription
primaryColor / secondaryColor / accentColorstring6-digit hex colors (e.g. #F97066)
logoUrlstringURL to your logo, max 512 chars
logoPlacementenumtop, bottom, or none
fontHeading / fontBodystringFont family names, max 100 chars
toneenumBrand voice: professional, casual, playful, bold, or minimal
industrystringYour industry, max 100 chars
companyDescriptionstringWhat your company does, max 2000 chars — feeds AI copywriting
stylePreferenceenumVisual style: modern, classic, bold, minimal, or playful
defaultCtaStyleenumDefault 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.

StatusMeaning
403Free plan (code: PLAN_REQUIRED) or missing account:settings:edit permission
422The website couldn't be reached (code: FETCH_FAILED)
429Rate 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

On this page