brand_create · AdCrunch Docs

Create a brand in your organization. Every context section is optional — start with a name and fill it in over time.

Creates a Brand in your organization. Its slug — the stable handle agents use — is derived from the name unless you pass one explicitly.

Input

Field	Type	Required	Description
`name`	`string`	yes	Display name.
`description`	`string`	yes	One-line summary, used when listing brands.
`identity`	`string`	no	Positioning, mission, offering, category (markdown).
`voice`	`string`	no	Tone of voice and personality (markdown).
`guidelines`	`string`	no	Do’s and don’ts, claims to avoid (markdown).
`messaging`	`string`	no	Key messages, value props, proof points (markdown).
`slug`	`string`	no	Explicit handle; normalized to kebab-case.

Every context section is optional. A brand with nothing but a name and description is a valid starting point — you’re expected to fill it in as you go, not to write the whole thing up front.

Output

The created brand, including its slug and revision (which starts at 1).

Example

“Set up a brand for Acme Running — direct, unfussy tone, never hype it.”

brand_create({
  name: 'Acme Running',
  description: 'DTC running shoes.',
  voice: 'Direct, unfussy, never hype.',
});
// → { slug: 'acme-running', revision: 1, identity: null, … }

Slugs must be unique

If a brand with the derived slug already exists, the call fails rather than silently adding a suffix. Choose a different name, or pass an explicit slug.

Requires the brand:write scope.