Content ID

Add YouTube channels to the whitelist

Adds up to 50 channels per request — to add more, make multiple requests. Accepts canonical channel IDs (UC…) or handles (@name); channels are validated against YouTube when the request is processed, and non-existent channels are rejected with a 422 listing the offending entries. The whitelist license is created automatically on your first add.

post/api/v1/content_id/channels

Request

Headers

Authorizationstring required

Your API token.

Request body

channel_idsstring[] required

Example request

{
  "channel_ids": [
    "UCzcptO1Z1TRFUIyu-z_2NKQ",
    "@melodiemusic"
  ]
}

Response

Updated whitelist license state

Example response

{
  "data": {
    "id": "WL7K2M9QXA",
    "type": "content_id_whitelist",
    "attributes": {
      "expiration_date": "2027-10-28",
      "channels_count": 3
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.