Skip to main content

​
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

FieldTypeRequiredDescription
__typestringYesMust be youtube
titlestringYesVideo title (2-100 characters)
typestringYesVideo visibility
selfDeclaredMadeForKidsstringNoMade for kids declaration
thumbnailobjectNoCustom thumbnail
tagsarrayNoVideo tags

​
title

Video title with the following constraints:
  • Minimum: 2 characters
  • Maximum: 100 characters

​
type (visibility)

ValueDescription
publicAnyone can search for and view
unlistedAnyone with the link can view
privateOnly you can view

​
selfDeclaredMadeForKids

ValueDescription
yesContent is made for kids
noContent is not made for kids

​
thumbnail

Custom thumbnail object (uploaded via the uploads endpoint): 
{
  "thumbnail": {
    "id": "thumbnail-id",
    "path": "https://uploads.socialsyncs.co/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 SocialSyncs 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.socialsyncs.co/tutorial.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "youtube",
        "title": "How to Use SocialSyncs API - Complete Tutorial",
        "type": "public",
        "selfDeclaredMadeForKids": "no",
        "tags": [
          { "value": "socialsyncs", "label": "socialsyncs" },
          { "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.socialsyncs.co/video.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "youtube",
        "title": "My Awesome Video",
        "type": "public",
        "selfDeclaredMadeForKids": "no",
        "thumbnail": {
          "id": "thumb-id",
          "path": "https://uploads.socialsyncs.co/thumbnail.jpg"
        },
        "tags": []
      }
    }
  ]
}

​
Private/Unlisted Video

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