YouTube Settings
OpenQuok public API provider settings for YouTube — title, privacy, tags, made-for-kids, and custom thumbnail on video uploads.
2 min read
Connect your agent today
Draft from chat, review in your calendar, and publish only what you approve.
Quick reference
| Property | Value |
|---|---|
| Identifier | youtube |
| Connect | GET /api/v1/public/social/youtube (+ channel picker) |
| Setup guide | YouTube |
| Description cap | 5,000 characters on top-level body |
| Main-post media | Exactly one MP4 video — required |
Note
title is required (**2–100** characters) in provider settings. The top-level body is the video description. YouTube does not support scheduled follow-up comments in OpenQuok.
Settings on create post
Flat keys and the youtube nested bucket are both accepted.
| Flat CLI / API key | Nested composer bucket | Purpose |
|---|---|---|
| title | youtube.title | Video title (2–100 chars, required) |
| type | youtube.type | public, private, or unlisted |
| selfDeclaredMadeForKids | youtube.selfDeclaredMadeForKids | yes or no |
| tags | youtube.tags | Snippet tags (strings or { value, label } objects) |
| thumbnail / thumbnailPath | youtube.thumbnail | Custom thumbnail { path } from upload |
{
"providerSettingsByIntegrationId": {
"<youtube-integration-id>": {
"title": "Product walkthrough — May 2026",
"type": "unlisted",
"selfDeclaredMadeForKids": "no",
"tags": [{ "value": "saas", "label": "saas" }],
"thumbnail": { "path": "FILE_PATH_FROM_THUMBNAIL_UPLOAD" }
}
}
}Field reference
| Field | Type | Required | Notes |
|---|---|---|---|
| title / youtube.title | string | Yes | 2–100 characters |
| type / youtube.type | string | No | Privacy status; default public |
| selfDeclaredMadeForKids | string | No | COPPA declaration: yes or no |
| tags / youtube.tags | array | No | Optional video tags |
| thumbnail / thumbnailPath | object or string | No | Storage path from POST /api/v1/public/upload |
Complete example
curl -X POST https://api.openquok.com/api/v1/public/posts
-H "Authorization: Bearer opo_your_programmatic_token"
-H "Content-Type: application/json"
-d '{
"body": "In this video we walk through the new dashboard and scheduling flow.",
"scheduledAt": "2026-05-15T16:00:00.000Z",
"status": "scheduled",
"integrationIds": ["<youtube-integration-id>"],
"isGlobal": true,
"media": [{ "id": "video-1", "path": "FILE_PATH_FROM_UPLOAD" }],
"providerSettingsByIntegrationId": {
"<youtube-integration-id>": {
"title": "Dashboard walkthrough — May 2026",
"type": "public",
"selfDeclaredMadeForKids": "no"
}
}
}'