• Applicable Software: MokonyxSocial
  • Min Version Number: 01.03.00 and later
  • Max Version Number: Not Applicable

MokonyxSocial posts to YouTube through the YouTube Data API v3 — usually as a community post or a content update on your channel. Since YouTube is video-centric, uploading a real video needs a media file, so text-only Joomla content maps to community posts rather than new videos.

What you need

  • A Google account with a YouTube channel.
  • A Google Cloud project with the YouTube Data API v3 enabled.
  • An OAuth 2.0 access_token carrying the right YouTube scope.

Get your credentials

Access token access_token (required)

This is the OAuth token that lets MokonyxSocial act on your YouTube channel. To get it:

  1. Open the Google Cloud Console at https://console.cloud.google.com/ and create or pick a project.
  2. Go to APIs & Services → Library, search YouTube Data API v3, and click Enable.
  3. Open APIs & Services → OAuth consent screen and set it up (add yourself as a test user if the app isn't verified).
  4. Under APIs & Services → Credentials → Create Credentials → OAuth client ID, create an OAuth client and note its ID and secret.
  5. Run the OAuth flow — the OAuth 2.0 Playground at https://developers.google.com/oauthplayground works well — using the scope https://www.googleapis.com/auth/youtube.force-ssl to authorize your channel and get an access token (plus a refresh token).
  6. Copy the access token.

Set it up in MokonyxSocial

  1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
  2. Choose YouTube.
  3. Enter the credentials above.
  4. Click Send Test to verify, then Save & Close and make sure it's Published.

Verify

When Send Test passes, open YouTube Studio and check your channel's community posts (or video list) for the test item. Then publish a Joomla article and confirm the post shows up.

Troubleshooting

  • 401 "Invalid Credentials": Google access tokens only last about an hour — refresh with your refresh token or re-run OAuth.
  • 403 "insufficientPermissions": re-authorize with the youtube.force-ssl scope.
  • 403 "quotaExceeded": you used up the daily quota (10,000 units by default) — wait for the reset or ask Google for more.
  • "channelNotFound": your Google account has no YouTube channel yet — create one first.

Notes & limits

  • Access tokens expire in ~1 hour, so you'll need a refresh flow for ongoing posting.
  • The Data API defaults to 10,000 quota units/day, and writes/uploads cost a lot of units.
  • Real video uploads need a media file; text content becomes a community post, and community posting is only available to eligible channels.