YouTube Settings

API settings for posting to YouTube

Settings Schema

When uploading a video to YouTube, use the following settings schema:

{
  "settings": {
    "__type": "youtube",
    "title": "My Video Title",
    "type": "public",
    "selfDeclaredMadeForKids": "no",
    "thumbnail": null,
    "tags": []
  }
}

Fields

Field	Type	Required	Description
__type	string	Yes	Must be youtube
title	string	Yes	Video title (2-100 characters)
type	string	Yes	Video visibility
selfDeclaredMadeForKids	string	No	Made for kids declaration
thumbnail	object	No	Custom thumbnail
tags	array	No	Video tags

title

Video title with the following constraints:

• Minimum: 2 characters
• Maximum: 100 characters

type (visibility)

Value	Description
public	Anyone can search for and view
unlisted	Anyone with the link can view
private	Only you can view

selfDeclaredMadeForKids

Value	Description
yes	Content is made for kids
no	Content is not made for kids

thumbnail

Custom thumbnail object (uploaded via the uploads endpoint):

{
  "thumbnail": {
    "id": "thumbnail-id",
    "path": "https://uploads.sipstory.tech/thumbnail.jpg"
  }
}

tags

Array of tag objects for video SEO:

{
  "tags": [
    { "value": "tech", "label": "tech" },
    { "value": "tutorial", "label": "tutorial" }
  ]
}

---

Complete Example

Public Video with Tags

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-youtube-integration-id"
      },
      "value": [
        {
          "content": "In this video, I'll show you how to use the Sipstory API to automate your social media workflow.\n\nTimestamps:\n0:00 Introduction\n1:30 Setup\n5:00 First API call\n10:00 Conclusion",
          "image": [
            {
              "id": "video-id",
              "path": "https://uploads.sipstory.tech/tutorial.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "youtube",
        "title": "How to Use Sipstory API - Complete Tutorial",
        "type": "public",
        "selfDeclaredMadeForKids": "no",
        "tags": [
          { "value": "sipstory", "label": "sipstory" },
          { "value": "api", "label": "api" },
          { "value": "tutorial", "label": "tutorial" },
          { "value": "social media automation", "label": "social media automation" }
        ]
      }
    }
  ]
}

Video with Custom Thumbnail

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-youtube-integration-id"
      },
      "value": [
        {
          "content": "Full video description here...",
          "image": [
            {
              "id": "video-id",
              "path": "https://uploads.sipstory.tech/video.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "youtube",
        "title": "My Awesome Video",
        "type": "public",
        "selfDeclaredMadeForKids": "no",
        "thumbnail": {
          "id": "thumb-id",
          "path": "https://uploads.sipstory.tech/thumbnail.jpg"
        },
        "tags": []
      }
    }
  ]
}

Private/Unlisted Video

{
  "settings": {
    "__type": "youtube",
    "title": "Private Team Update",
    "type": "unlisted",
    "selfDeclaredMadeForKids": "no",
    "tags": []
  }
}