Create Brand

curl --request POST \
  --url https://api.sigmora.org/v1/brands \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "PocketLedger",
  "niche": "personal finance for first-time earners",
  "description": "Short, practical money habits for people in their first five years of work.",
  "accentColor": "#d66428",
  "products": [
    "pocketledger"
  ]
}
'

import requests

url = "https://api.sigmora.org/v1/brands"

payload = {
    "name": "PocketLedger",
    "niche": "personal finance for first-time earners",
    "description": "Short, practical money habits for people in their first five years of work.",
    "accentColor": "#d66428",
    "products": ["pocketledger"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'PocketLedger',
    niche: 'personal finance for first-time earners',
    description: 'Short, practical money habits for people in their first five years of work.',
    accentColor: '#d66428',
    products: ['pocketledger']
  })
};

fetch('https://api.sigmora.org/v1/brands', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "brand": {
    "id": "<string>",
    "slug": "<string>",
    "name": "<string>",
    "enabled": true,
    "products": [
      "<string>"
    ],
    "niche": "<string>"
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

POST

brands

Create Brand

curl --request POST \
  --url https://api.sigmora.org/v1/brands \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "PocketLedger",
  "niche": "personal finance for first-time earners",
  "description": "Short, practical money habits for people in their first five years of work.",
  "accentColor": "#d66428",
  "products": [
    "pocketledger"
  ]
}
'

import requests

url = "https://api.sigmora.org/v1/brands"

payload = {
    "name": "PocketLedger",
    "niche": "personal finance for first-time earners",
    "description": "Short, practical money habits for people in their first five years of work.",
    "accentColor": "#d66428",
    "products": ["pocketledger"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'PocketLedger',
    niche: 'personal finance for first-time earners',
    description: 'Short, practical money habits for people in their first five years of work.',
    accentColor: '#d66428',
    products: ['pocketledger']
  })
};

fetch('https://api.sigmora.org/v1/brands', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "brand": {
    "id": "<string>",
    "slug": "<string>",
    "name": "<string>",
    "enabled": true,
    "products": [
      "<string>"
    ],
    "niche": "<string>"
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

A workspace API key.

Headers

idempotency-key

string

Optional. Your stable id for this create; reuse it after a timeout to receive the same result instead of creating a duplicate.

Required string length: 1 - 200

Example:

"create-2026-08-12-0001"

Body

application/json

name

string

required

The only required field.

Required string length: 1 - 120

niche

string

Plain-language subject area, e.g. personal finance for first-time investors.

Maximum string length: 200

description

string

What this Brand publishes, who it serves, and any important positioning.

Maximum string length: 2000

accentColor

string

Brand colour, e.g. #d66428.

Maximum string length: 32

voicePreset

string

Named voice preset the engine writes this Brand in.

Maximum string length: 120

products

Product binding ids (from /v1/products), or 'none' to declare this Brand promotes nothing. An empty array means 'nothing bound yet'; 'none' means 'deliberately never' — the engine reads the difference.

Maximum array length: 50

Required string length: 1 - 40

Response

Success.

success

boolean

required

brand

object

required

A cross-platform Brand with its own identity and rules.

Show child attributes

{key}

any

Meta

Projects

Sessions

Assets

Jobs

Text

Video

UGC

Editing

3D

Image

Audio

Publishing

Webhooks

Workflows

Agents

Research

Themes

Signals

Discovery

Watchlist

Performance

Autopilot

Campaigns

Brands

Products

Create Brand

Authorizations

Headers

Body

Response