YouTube Settings

Creating the OAuth app and connecting a channel: YouTube setup guide.

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.postqueen.ai/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 PostQueen 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.postqueen.ai/tutorial.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "youtube",
        "title": "How to Use PostQueen API - Complete Tutorial",
        "type": "public",
        "selfDeclaredMadeForKids": "no",
        "tags": [
          { "value": "postqueen", "label": "postqueen" },
          { "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.postqueen.ai/video.mp4"
            }
          ]
        }
      ],
      "settings": {
        "__type": "youtube",
        "title": "My Awesome Video",
        "type": "public",
        "selfDeclaredMadeForKids": "no",
        "thumbnail": {
          "id": "thumb-id",
          "path": "https://uploads.postqueen.ai/thumbnail.jpg"
        },
        "tags": []
      }
    }
  ]
}

Private/Unlisted Video

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

Getting Started

Endpoints

Posting settings by platform

Build on PostQueen

Settings Schema

Fields

`title`

`type` (visibility)

`selfDeclaredMadeForKids`

`thumbnail`

`tags`

Complete Example

Public Video with Tags

Video with Custom Thumbnail

Private/Unlisted Video

​Settings Schema

​Fields

​title

​type (visibility)

​selfDeclaredMadeForKids

​thumbnail

​tags

​Complete Example

​Public Video with Tags

​Video with Custom Thumbnail

​Private/Unlisted Video

Settings Schema

Fields

`title`

`type` (visibility)

`selfDeclaredMadeForKids`

`thumbnail`

`tags`

Complete Example

Public Video with Tags

Video with Custom Thumbnail

Private/Unlisted Video