Appearance
Brand styles
A brand style holds the look of your emails: colours, fonts, social links and images such as your logo. Email content takes its styling from a brand style, so one brand style keeps every email on brand.
For a step-by-step flow, use the Create a brand style workflow.
Every tool also takes the optional account_id (see Accounts). It is left out of the tables below.
What a brand style contains
Colours
Each colour fills a slot. The slot names used by the tools differ from the labels in Rule:
Slot (type) | Label in Rule | What it colours |
|---|---|---|
accent | Primary | Buttons. Your main brand colour. |
brand | Secondary | Accent backgrounds |
dark | Text | Text |
light | Background | The background inside content blocks |
side | Canvas | The area around the email content |
WARNING
Despite its name, brand is not your main colour. When you talk about "my brand colour", the assistant uses the accent slot (Primary).
A colour is given as { type, hex, brightness }, for example { type: "accent", hex: "#05CC87", brightness: 180 }. brightness is a number from 0 to 255.
Fonts
A title font and a body font (type: title or body). Each is a Google font by name (such as "Roboto"), a system font, or a custom font file (TTF, OTF, WOFF or WOFF2, up to 4 MB).
Social links
Links to facebook, instagram, linkedin, twitter, youtube, tiktok, pinterest, github, crunchbase or your website, each as a full URL.
Images
A logo, icon, symbol or banner, from a public URL or uploaded directly. PNG or JPEG only, up to 10 MB each. An image in another format (such as GIF, WebP or SVG) is skipped.
If an image or font cannot be downloaded or is not accepted, the brand style is still saved without it, and the answer lists what was skipped in warnings.
list-brand-styles
Lists the account's brand styles with their id, name and which one is the default.
This tool takes no other parameters.
Try asking: "What brand styles do I have?"
get-brand-style
Shows one brand style with all its colours, fonts, links and images.
| Parameter | Type | Required | Description |
|---|---|---|---|
brand_style_id | number | Yes | The brand style's id. |
Try asking: "Show me the colours and fonts of my Acme brand style."
create-brand-style
Creates a brand style. Only the name is needed; everything else can be added now or later.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name, up to 100 characters. Must be unique in the account. |
description | string | No | Description. |
is_default | boolean | No | Make it the account's default brand style. |
colours | array | No | See Colours. |
fonts | array | No | See Fonts. |
links | array | No | See Social links. |
images | array | No | See Images. |
domain | string | No | An internal identifier, unique in the account. It is not a website address, and you can leave it out. |
Try asking: "Create a brand style called Acme with primary colour #05CC87, Roboto headings and our LinkedIn page."
update-brand-style
Changes a brand style. Only what you mention is changed.
| Parameter | Type | Required | Description |
|---|---|---|---|
brand_style_id | number | Yes | The brand style's id. |
name, description, is_default, domain | No | As in create-brand-style. | |
colours, fonts, links, images | array | No | A list you give replaces all current items of that kind; [] removes them. Leave a list out to keep it. |
Changing one colour
Because a list replaces what is there, the assistant sends all colours, including the ones you did not change.
Try asking: "Change the primary colour of my Acme brand style to #FF5500."
copy-brand-style
Duplicates a brand style, in the same account or into another account you have access to.
| Parameter | Type | Required | Description |
|---|---|---|---|
brand_style_id | number | Yes | The brand style to copy. |
new_name | string | No | Name of the copy. Defaults to <name> (copy <date and time>). |
source_account_id | number | No | To copy to another account: the account to copy from. Give it together with target_account_id. |
target_account_id | number | No | The account to copy to. |
- Everything is copied: colours, fonts, links and images.
- The copy is never the default brand style. Make it the default with
update-brand-style. - Anything that could not be copied is listed in
warnings.
Try asking: "Copy my Acme brand style to my Norwegian account."
create-brand-style-from-domain
Creates a brand style from your website: Rule fetches your logo, colours, fonts and social links automatically (using BrandFetch).
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Your website's domain, such as acme.com, without https:// or a path. |
- Fails if the account already has a brand style for that domain, or if no brand data is found for it.
- Adjust the result afterwards with
update-brand-style.
Try asking: "Create a brand style from acme.com."