Method: whitelists.insert
Stay organized with collections
Save and categorize content based on your preferences.
Whitelist a YouTube channel for your content owner. Whitelisted channels are channels that are not owned or managed by you, but you would like to whitelist so that no claims from your assets are placed on videos uploaded to these channels.
HTTP request
POST https://youtubepartner.googleapis.com/youtube/partner/v1/whitelists
The URL uses gRPC Transcoding
syntax.
Query parameters
| Parameters |
onBehalfOfContentOwner
|
string
The onBehalfOfContentOwner
parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.
|
Request body
The request body contains an instance of Whitelist
.
Response body
If successful, the response body contains a newly created instance of Whitelist
.
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/youtubepartner
For more information, see the OAuth 2.0 Overview
.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis page describes how to whitelist a YouTube channel, ensuring videos on that channel won't receive claims from your assets.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves sending a POST request to the specified endpoint: \u003ccode\u003ehttps://youtubepartner.googleapis.com/youtube/partner/v1/whitelists\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request must include the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e query parameter, specifying the content owner.\u003c/p\u003e\n"],["\u003cp\u003eThe request and response bodies are both structured as instances of the \u003ccode\u003eWhitelist\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eAuthorizing this request requires the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This documentation details how to whitelist a YouTube channel. A `POST` request is sent to `https://youtubepartner.googleapis.com/youtube/partner/v1/whitelists`. The `onBehalfOfContentOwner` query parameter specifies the content owner. The request body, a `Whitelist` instance, is used. A successful operation returns a new `Whitelist` instance in the response body. The request requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope.\n"],null,["# Method: whitelists.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nWhitelist a YouTube channel for your content owner. Whitelisted channels are channels that are not owned or managed by you, but you would like to whitelist so that no claims from your assets are placed on videos uploaded to these channels.\n\n### HTTP request\n\n`POST https://youtubepartner.googleapis.com/youtube/partner/v1/whitelists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `onBehalfOfContentOwner` | `string` The `onBehalfOfContentOwner` parameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners. |\n\n### Request body\n\nThe request body contains an instance of [Whitelist](/youtube/partner/reference/rest/v1/whitelists#Whitelist).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Whitelist](/youtube/partner/reference/rest/v1/whitelists#Whitelist).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/youtubepartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
