How to Whitelist YouTube Channels for Licensing

  1. Overview
  2. Uploading
  3. How to Whitelist YouTube Channels for Licensing

Welcome!

If you need to whitelist a YouTube channel to clear a non-exclusive copyright claim, we have you covered. Whether you prefer a quick manual setup or want to completely automate the process via our backend API, you can clear claims seamlessly. This guide will explain both options with clear operational instructions.

Important Notes About Whitelisting

Before executing a whitelist command, please review our network terms regarding digital clearing parameters:

  • One-Time License Clearance: Whitelisting grants a one-time license to a specified YouTube channel for a single video asset in perpetuity. If the same track is used in a brand-new video on that same channel, a separate whitelist entry must be processed.

  • Granular Submission: To ensure proper tracking and avoid sweeping systemic conflicts, we highly recommend triggering a distinct whitelist request per download, client purchase, or unique usage event.

  • Strict Eligibility Tiering:

    • Non-Exclusive Tracks: Whitelisting rules apply by default to all active non-exclusive tracks handled by our system.

    • Exclusive Tracks: Because exclusive tracks are completely independent and are never registered under That Pitch’s automated Content ID system, they cannot be whitelisted through our dashboard. You must manage, clear, and white-list your exclusive placements independently through your personal Content ID administrator.

Option 1: Manually Whitelist Channels

If you are manually handling a small volume of client clearance requests, you can clear them directly inside your profile settings:

  1. Log in to your active That Pitch account.

  2. Navigate to Settings → Licensing.

  3. Copy and paste the exact, full YouTube channel URL or video link into the designated field.

  4. Click Grant License. The channel link is instantly added to our clearing log, and automated Content ID claims will be dropped within 24 hours.

Option 2: Automate Whitelisting with a Webhook

For high-volume platforms, marketplaces, or frequent licensing flows, you can streamline your operations using our webhook infrastructure. Select the implementation method below that best fits your technical capability.

No-Code Setup (Via Zapier)

If you do not have a development team, you can build an automated workflow using Zapier:

  1. Request Your Webhook Access Data: Send an authenticated support ticket through your dashboard with the subject line: "Library Request for User ID & Webhook URL – YouTube Whitelisting." Our engineering team will return your unique User ID string and secure Webhook target URL.

  2. Configure Your Trigger: Log into Zapier and establish a custom trigger based on your sales funnel (e.g., a successful customer checkout on Shopify, a digital download event, or an external form submission).

  3. Configure the Action: Choose Webhook by Zapier as your action step and select POST as the operation method.

  4. Map Your Payload Data: Input the following settings precisely inside your Zapier action window:

    • URL: Paste the custom webhook URL provided by our support team.

    • Headers: Set the Key to Content-Type and the Value to application/json.

    • Data Layout: Use a raw JSON structure matching this exact format, replacing the bracketed fields dynamically with your trigger data:

JSON

{
  "userId": "YOUR_UNIQUE_USER_ID",
  "youtubeUrl": "https://www.youtube.com/channel/CLIENT_CHANNEL_ID"
}

Technical Team Setup (Direct API Integration)

If you have an in-house engineering team, they can inject our endpoint directly into your platform's backend architecture.

  1. Endpoint Acquisition: Request your unique administrative credentials and destination URLs by submitting an authenticated dashboard support ticket.

  2. Request Payload Parameters: Construct a standard POST request directed at our endpoint carrying the following strict JSON payload:

JSON

{
  "userId": "8aa10256-ecc3-42c2-b2d2-780ebf56ad27",
  "youtubeUrl": "https://www.youtube.com/channel/UCj9xyDPlY8rPd-FascOoktA"
}

Example cURL Request:

Bash

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"userId":"8aa10256-ecc3-42c2-b2d2-780ebf56ad27","youtubeUrl":"https://www.youtube.com/channel/UCj9xyDPlY8rPd-FascOoktA"}' \
  [WEBHOOK_URL_PROVIDED_BY_SUPPORT]

  1. Production Integration: Wire this POST command directly to your core database events. The most common integration triggers include:

    • Purchases: Instantly whitelisting a channel the second an external buyer buys a sync license on your store.

    • Downloads: Triggering the API clearance when a user downloads an audio file from your personal subscription library.

    • Form Submissions: Processing the payload when an authorized client submits an embedded request form on your landing pages.

Simple version: Non-exclusive tracks can be whitelisted manually through your Settings tab or automated using our developer webhook payload. Because exclusive tracks are never registered or tracked by That Pitch's automated Content ID system, they cannot be whitelisted here—you must clear them independently.