Brand

Configure brand identity for on-brand email generation.

Brand settings power ClawdMail's AI generation. The more context you provide — colors, voice guidelines, brand story — the better your generated emails will match your identity.

GET/api/v1/brand

Get the current brand settings for your workspace.

Example

curl https://app.clawdmail.ai/api/v1/brand \
  -H "Authorization: Bearer cm_live_your_key"

Response

{
  "data": {
    "name": "Acme Inc",
    "primaryColor": "#3B82F6",
    "secondaryColor": "#1E293B",
    "accentColor": "#F59E0B",
    "fontFamily": "Inter",
    "voiceGuidelines": "Friendly, concise, and technical. Avoid jargon.",
    "industry": "Developer Tools",
    "brandStory": "Acme helps developers ship faster with AI-powered tooling."
  }
}

PUT/api/v1/brand

Update brand settings. All fields are optional — only provided fields will be updated.

Parameters

Name	Type	Description
`name`	string	Company or brand name
`primaryColor`	string	Primary brand color (hex)
`secondaryColor`	string	Secondary brand color (hex)
`accentColor`	string	Accent color for CTAs and highlights (hex)
`fontFamily`	string	Preferred font family
`voiceGuidelines`	string	Tone and voice instructions for AI generation
`industry`	string	Industry vertical for contextual generation
`brandStory`	string	Brief company story or mission statement

Example

curl -X PUT https://app.clawdmail.ai/api/v1/brand \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Inc",
    "primaryColor": "#3B82F6",
    "voiceGuidelines": "Friendly, concise, and technical. Avoid jargon.",
    "industry": "Developer Tools"
  }'

Response

{
  "data": {
    "name": "Acme Inc",
    "primaryColor": "#3B82F6",
    "secondaryColor": null,
    "accentColor": null,
    "fontFamily": null,
    "voiceGuidelines": "Friendly, concise, and technical. Avoid jargon.",
    "industry": "Developer Tools",
    "brandStory": null
  }
}

POST/api/v1/brand/extract

Automatically extract brand identity from any URL. ClawdMail crawls the page and pulls colors, fonts, tone, and company info to populate your brand settings.

Parameters

Name	Type	Description
`url`required	string	Website URL to extract brand from

Example

curl -X POST https://app.clawdmail.ai/api/v1/brand/extract \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://acme.com" }'

Response

{
  "data": {
    "name": "Acme Inc",
    "primaryColor": "#3B82F6",
    "secondaryColor": "#1E293B",
    "accentColor": "#F59E0B",
    "fontFamily": "Inter",
    "voiceGuidelines": "Professional yet approachable. Uses clear, jargon-free language with a focus on developer experience.",
    "industry": "Developer Tools",
    "brandStory": "Acme helps developers ship faster with AI-powered tooling and seamless integrations."
  }
}