API Reference

YouTube — Own API Quota

Dedicated quota via Google Cloud

By default, all YouTube uploads share CodivUpload's API quota (10,000 units/day platform-wide). To get your own dedicated quota, create a Google Cloud project and enter your credentials.

Your own 10,000 units/day = ~66 video uploads/day, independent of other users.

Step 1: Create a Google Cloud Project

Go to console.cloud.google.com and click Create or select a projectNew Project.

Google Cloud Welcome screen

Step 2: Select Your Project

Make sure your new project is selected in the top dropdown.

Select Project dropdown

Step 3: Enable YouTube Data API v3

Go to APIs & Services → Library, search for YouTube Data API v3 and click Enable.

Enable YouTube Data API v3

Step 4: Configure OAuth Consent Screen

Go to Google Auth Platform → Get Started:

  1. Set app name and provide your email
  2. Select External audience
  3. Add your email as test user
  4. Under Data Access, add scopes: youtube.upload, youtube, youtube.readonly, yt-analytics.readonly
OAuth Consent Screen configuration

Step 5: Create OAuth Credentials

Go to Clients → + Create Client → Select Web application.

Add this Authorized redirect URI:

https://app.codivupload.com/api/v1/integrations/youtube/callback

Copy the Client ID and Client Secret.

Create OAuth credentials

Step 6: Connect in CodivUpload

  1. Go to Profiles → click YouTube
  2. Check "Use my own YouTube API credentials"
  3. Paste your Client ID and Client Secret
  4. Click Continue → authorize with Google
Important: Add yourself as a test user in Audience → Test users. Without this, you'll get an "Access blocked" error.

Refresh Token Expiry

Apps in testing mode have refresh tokens that expire after 7 days. You'll receive a notification before expiry and can re-authorize with one click from the dashboard.

Privacy & Data Usage

CodivUpload's use of Google user data is strictly limited to publishing content and displaying analytics on your behalf. We adhere to Google's requirements for applications accessing YouTube API services:

Limited Use: CodivUpload complies with the Google API Services User Data Policy, including the Limited Use requirements. We only access the YouTube scopes necessary for video uploading, channel management, and analytics retrieval.

Token Security: All OAuth tokens (access tokens and refresh tokens) are encrypted using AES-256-GCM before storage. Tokens are never logged, exposed in URLs, or accessible to CodivUpload staff.

No Third-Party Sharing: Your Google data is never sold, shared with third parties, or used for advertising purposes. Data access is limited to the functionality you explicitly authorized.

Revocation: You can disconnect your YouTube account at any time from the Profiles page. This immediately deletes all stored tokens and revokes CodivUpload's access to your Google account.