Attach Brand destination

curl --request POST \
  --url https://api.sigmora.org/v1/brands/{brandId}/destinations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connectedAccountId": "acct_youtube_main",
  "lane": "short-form",
  "schedule": {
    "posts": 3,
    "period": "week",
    "activeDays": [
      1,
      3,
      5
    ],
    "maxPostsPerDay": 1,
    "timezone": "Africa/Nairobi",
    "postingWindows": [
      {
        "startHour": 18,
        "endHour": 21
      }
    ],
    "minIntervalHours": 0
  },
  "contentFormats": [
    "talking-head",
    "voiceover-faceless"
  ],
  "automationLevel": "prepare-drafts"
}
'

import requests

url = "https://api.sigmora.org/v1/brands/{brandId}/destinations"

payload = {
    "connectedAccountId": "acct_youtube_main",
    "lane": "short-form",
    "schedule": {
        "posts": 3,
        "period": "week",
        "activeDays": [1, 3, 5],
        "maxPostsPerDay": 1,
        "timezone": "Africa/Nairobi",
        "postingWindows": [
            {
                "startHour": 18,
                "endHour": 21
            }
        ],
        "minIntervalHours": 0
    },
    "contentFormats": ["talking-head", "voiceover-faceless"],
    "automationLevel": "prepare-drafts"
}
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({
    connectedAccountId: 'acct_youtube_main',
    lane: 'short-form',
    schedule: {
      posts: 3,
      period: 'week',
      activeDays: [1, 3, 5],
      maxPostsPerDay: 1,
      timezone: 'Africa/Nairobi',
      postingWindows: [{startHour: 18, endHour: 21}],
      minIntervalHours: 0
    },
    contentFormats: ['talking-head', 'voiceover-faceless'],
    automationLevel: 'prepare-drafts'
  })
};

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

{
  "success": true,
  "destination": {
    "id": "<string>",
    "contentBrandId": "<string>",
    "connectedAccountId": "<string>",
    "platform": "tiktok",
    "lane": "long-form",
    "status": "active",
    "schedule": {
      "posts": 50,
      "period": "day",
      "activeDays": [
        3
      ],
      "maxPostsPerDay": 10,
      "timezone": "<string>",
      "postingWindows": [
        {
          "startHour": 11,
          "endHour": 11,
          "daysOfWeek": [
            3
          ]
        }
      ],
      "minIntervalHours": 84
    },
    "contentFormats": [
      "talking-head"
    ],
    "automationLevel": "remind-only",
    "reminders": {
      "enabled": true,
      "leadDays": 7,
      "cooldownHours": 171,
      "channels": [
        "email"
      ],
      "includeTrendIdeas": true,
      "includeDraftScript": true,
      "customInstructions": "<string>"
    },
    "version": 123,
    "effectiveFrom": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<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

{brandId}

destinations

Attach Brand destination

curl --request POST \
  --url https://api.sigmora.org/v1/brands/{brandId}/destinations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connectedAccountId": "acct_youtube_main",
  "lane": "short-form",
  "schedule": {
    "posts": 3,
    "period": "week",
    "activeDays": [
      1,
      3,
      5
    ],
    "maxPostsPerDay": 1,
    "timezone": "Africa/Nairobi",
    "postingWindows": [
      {
        "startHour": 18,
        "endHour": 21
      }
    ],
    "minIntervalHours": 0
  },
  "contentFormats": [
    "talking-head",
    "voiceover-faceless"
  ],
  "automationLevel": "prepare-drafts"
}
'

import requests

url = "https://api.sigmora.org/v1/brands/{brandId}/destinations"

payload = {
    "connectedAccountId": "acct_youtube_main",
    "lane": "short-form",
    "schedule": {
        "posts": 3,
        "period": "week",
        "activeDays": [1, 3, 5],
        "maxPostsPerDay": 1,
        "timezone": "Africa/Nairobi",
        "postingWindows": [
            {
                "startHour": 18,
                "endHour": 21
            }
        ],
        "minIntervalHours": 0
    },
    "contentFormats": ["talking-head", "voiceover-faceless"],
    "automationLevel": "prepare-drafts"
}
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({
    connectedAccountId: 'acct_youtube_main',
    lane: 'short-form',
    schedule: {
      posts: 3,
      period: 'week',
      activeDays: [1, 3, 5],
      maxPostsPerDay: 1,
      timezone: 'Africa/Nairobi',
      postingWindows: [{startHour: 18, endHour: 21}],
      minIntervalHours: 0
    },
    contentFormats: ['talking-head', 'voiceover-faceless'],
    automationLevel: 'prepare-drafts'
  })
};

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

{
  "success": true,
  "destination": {
    "id": "<string>",
    "contentBrandId": "<string>",
    "connectedAccountId": "<string>",
    "platform": "tiktok",
    "lane": "long-form",
    "status": "active",
    "schedule": {
      "posts": 50,
      "period": "day",
      "activeDays": [
        3
      ],
      "maxPostsPerDay": 10,
      "timezone": "<string>",
      "postingWindows": [
        {
          "startHour": 11,
          "endHour": 11,
          "daysOfWeek": [
            3
          ]
        }
      ],
      "minIntervalHours": 84
    },
    "contentFormats": [
      "talking-head"
    ],
    "automationLevel": "remind-only",
    "reminders": {
      "enabled": true,
      "leadDays": 7,
      "cooldownHours": 171,
      "channels": [
        "email"
      ],
      "includeTrendIdeas": true,
      "includeDraftScript": true,
      "customInstructions": "<string>"
    },
    "version": 123,
    "effectiveFrom": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<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"

Path Parameters

brandId

string

required

A Brand id, from GET /v1/brands.

Required string length: 1 - 200

Example:

"brd_4b81"

Body

application/json

connectedAccountId

string

required

A connected publishing-account id from the workspace.

Required string length: 1 - 200

Example:

"acct_youtube_main"

lane

enum<string>

required

Content lane this commitment measures, such as short-form or text.

Available options:

long-form,

short-form,

image,

text,

thread,

audio

schedule

object

required

The publishing cadence a Brand commits to on one destination: how many posts, on which days, in which time windows.

Show child attributes

contentFormats

enum<string>[]

required

Production formats Sigmora may propose for this lane.

Required array length: 1 - 9 elements

Available options:

talking-head,

ai-avatar,

voiceover-faceless,

screen-tutorial,

product-demo,

interview-podcast-clip,

repurposed-clip,

motion-graphics,

static-carousel

automationLevel

enum<string>

default:remind-only

Maximum assistance authorized for this destination; defaults to remind-only.

Available options:

remind-only,

suggest-ideas,

prepare-drafts,

render-for-review,

schedule-after-approval,

full-auto

reminders

object

When Sigmora may remind the workspace owner that a destination is falling behind its schedule.

Show child attributes

Response

Success.

success

boolean

required

destination

object

required

One Brand × connected account × content-lane consistency commitment.

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

Attach Brand destination

Authorizations

Headers

Path Parameters

Body

Response