Schedule a YouTube pack

curl --request POST \
  --url https://api.sigmora.org/v1/publish/pack \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "parentJobId": "job_7e3c2f",
  "connectedAccountId": "acct_youtube_main",
  "startAt": "2026-08-15T07:00:00Z",
  "playlistIds": [
    "PLx3f1c9a2b7d4e8f0"
  ],
  "timeZone": "Africa/Nairobi",
  "aiDisclosure": false
}
'

import requests

url = "https://api.sigmora.org/v1/publish/pack"

payload = {
    "parentJobId": "job_7e3c2f",
    "connectedAccountId": "acct_youtube_main",
    "startAt": "2026-08-15T07:00:00Z",
    "playlistIds": ["PLx3f1c9a2b7d4e8f0"],
    "timeZone": "Africa/Nairobi",
    "aiDisclosure": False
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    parentJobId: 'job_7e3c2f',
    connectedAccountId: 'acct_youtube_main',
    startAt: '2026-08-15T07:00:00Z',
    playlistIds: ['PLx3f1c9a2b7d4e8f0'],
    timeZone: 'Africa/Nairobi',
    aiDisclosure: false
  })
};

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

{
  "success": true,
  "parentJobId": "<string>",
  "connectedAccountId": "<string>",
  "timeZone": "<string>",
  "entries": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "title": "<string>",
      "queueItemId": "<string>",
      "releaseAt": "<string>",
      "uploadAt": "<string>",
      "status": "<string>",
      "alreadyQueued": true
    }
  ],
  "skipped": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "reason": "<string>"
    }
  ]
}

{
  "success": true,
  "parentJobId": "<string>",
  "connectedAccountId": "<string>",
  "timeZone": "<string>",
  "entries": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "title": "<string>",
      "queueItemId": "<string>",
      "releaseAt": "<string>",
      "uploadAt": "<string>",
      "status": "<string>",
      "alreadyQueued": true
    }
  ],
  "skipped": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "reason": "<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"
}

Schedule a YouTube pack

Schedule a footage edit’s whole pack on a YouTube channel. Queues the long cut and every finished short of one footage edit on one connected YouTube channel, each with its packaged title, description (chapters included), tags and thumbnail, released by YouTube’s own schedule: long videos 12 hours apart (or the channel’s own spacing), two shorts a day, each short at least an hour after its long video, never in the past, around everything already queued. Requires the separate publish API-key scope and a retry key; every output honors workspace approval policy. Repeating the call leaves queued outputs unchanged. Free.

POST

publish

pack

curl --request POST \
  --url https://api.sigmora.org/v1/publish/pack \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "parentJobId": "job_7e3c2f",
  "connectedAccountId": "acct_youtube_main",
  "startAt": "2026-08-15T07:00:00Z",
  "playlistIds": [
    "PLx3f1c9a2b7d4e8f0"
  ],
  "timeZone": "Africa/Nairobi",
  "aiDisclosure": false
}
'

import requests

url = "https://api.sigmora.org/v1/publish/pack"

payload = {
    "parentJobId": "job_7e3c2f",
    "connectedAccountId": "acct_youtube_main",
    "startAt": "2026-08-15T07:00:00Z",
    "playlistIds": ["PLx3f1c9a2b7d4e8f0"],
    "timeZone": "Africa/Nairobi",
    "aiDisclosure": False
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    parentJobId: 'job_7e3c2f',
    connectedAccountId: 'acct_youtube_main',
    startAt: '2026-08-15T07:00:00Z',
    playlistIds: ['PLx3f1c9a2b7d4e8f0'],
    timeZone: 'Africa/Nairobi',
    aiDisclosure: false
  })
};

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

{
  "success": true,
  "parentJobId": "<string>",
  "connectedAccountId": "<string>",
  "timeZone": "<string>",
  "entries": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "title": "<string>",
      "queueItemId": "<string>",
      "releaseAt": "<string>",
      "uploadAt": "<string>",
      "status": "<string>",
      "alreadyQueued": true
    }
  ],
  "skipped": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "reason": "<string>"
    }
  ]
}

{
  "success": true,
  "parentJobId": "<string>",
  "connectedAccountId": "<string>",
  "timeZone": "<string>",
  "entries": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "title": "<string>",
      "queueItemId": "<string>",
      "releaseAt": "<string>",
      "uploadAt": "<string>",
      "status": "<string>",
      "alreadyQueued": true
    }
  ],
  "skipped": [
    {
      "videoJobId": "<string>",
      "kind": "long",
      "reason": "<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

required

Required stable id for this logical write; reuse it after a timeout. Upload endpoints also require the same value in body.idempotencyKey.

Required string length: 1 - 255

Body

application/json

parentJobId

string

required

The footage edit (its parent job id, as video.edit returned it) whose finished long cut and shorts are scheduled.

Required string length: 1 - 200

connectedAccountId

string

required

A connected YouTube account from publish.destinations.list.

Required string length: 1 - 200

startAt

string<date-time>

Optional RFC 3339 earliest release; omit to release as soon as the upload allows (about two hours ahead). Must not be in the past.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

playlistIds

string[]

Optional YouTube playlist ids every video of the pack is added to after upload.

Maximum array length: 10

Required string length: 2 - 64

timeZone

string

Optional IANA zone of the audience, used when the channel has no Brand posting schedule; UTC otherwise.

Maximum string length: 64

aiDisclosure

boolean

Set true to mark every video as altered or synthetic content on YouTube. Your choice: Sigmora never sets it on its own.

Response

Success.

success

boolean

required

parentJobId

string

required

Required string length: 1 - 200

connectedAccountId

string

required

Required string length: 1 - 200

timeZone

string

required

The zone the plan was placed in.

entries

object[]

required

Each output and when it releases, earliest first.

Show child attributes

skipped

object[]

required

Outputs not scheduled, and why.

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

Schedule a YouTube pack

Authorizations

Headers

Body

Response