YouTube OAuth client setup
YouTube OAuth client setup begins with the provider application. Configure a Google Cloud Web application OAuth client for YouTube, enable YouTube Data API v3, and register the callback before connecting a channel.
Callback URL
Register {{API_BASE_URL}}/v1/connect/youtube/callback in the provider’s Authorized redirect URIs. Configure the API origin for your environment and keep the callback path unchanged.
Configure Google Cloud
- Create or select a project in Google Cloud Console and enable YouTube Data API v3.
- Complete the OAuth consent screen with the app name, support email, website, privacy policy and terms.
- While the publishing status is Testing, add the accounts that will test the app.
- Create an OAuth client with application type Web application and enter the callback under Authorized redirect URIs.
- Copy the client ID and client secret.
Permissions and access restrictions
Use the permission identifiers listed in the table. Authorization by accounts outside your test group may first need Google OAuth verification. Confirm the intended account is permitted for the app’s current publishing status.
Save the app before connecting an account
Open Integrations → Apps (BYOK) → New app and select YouTube. Fill the client ID and client secret fields using the credential map, then save the app record. Begin a new integration, pick that saved app, and only then choose YouTube for account authorization. Selecting the app first binds the connection to the intended credentials.
| Permission |
|---|
| https://www.googleapis.com/auth/youtube.upload |
| https://www.googleapis.com/auth/youtube.force-ssl |
Request only the capabilities your product uses and complete the provider’s review requirements.
| Provider value | BYOK field |
|---|---|
| Google client ID | client ID |
| client secret | client secret |
Store the secret in the app record; do not include it in a shared callback URL.
{{API_BASE_URL}}/v1/connect/youtube/callback