Skip to content

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 RuleWhat it colours
accentPrimaryButtons. Your main brand colour.
brandSecondaryAccent backgrounds
darkTextText
lightBackgroundThe background inside content blocks
sideCanvasThe 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).

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.

ParameterTypeRequiredDescription
brand_style_idnumberYesThe 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.

ParameterTypeRequiredDescription
namestringYesName, up to 100 characters. Must be unique in the account.
descriptionstringNoDescription.
is_defaultbooleanNoMake it the account's default brand style.
coloursarrayNoSee Colours.
fontsarrayNoSee Fonts.
linksarrayNoSee Social links.
imagesarrayNoSee Images.
domainstringNoAn 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.

ParameterTypeRequiredDescription
brand_style_idnumberYesThe brand style's id.
name, description, is_default, domainNoAs in create-brand-style.
colours, fonts, links, imagesarrayNoA 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.

ParameterTypeRequiredDescription
brand_style_idnumberYesThe brand style to copy.
new_namestringNoName of the copy. Defaults to <name> (copy <date and time>).
source_account_idnumberNoTo copy to another account: the account to copy from. Give it together with target_account_id.
target_account_idnumberNoThe 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).

ParameterTypeRequiredDescription
domainstringYesYour 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."