Connecting Gmail & YouTube

Google OAuth setup for email + YouTube channel posting.

Gmail (for sending pitch emails) and YouTube (for video uploads + metrics) both use Google sign-in, but they connect from different places and are approved separately.

Connecting

  1. Gmail: Settings → Gmail Integration → Connect. YouTube: Social Hub → Connect Accounts → YouTube → Connect

    Your browser opens to Google's sign-in page.

  2. Sign in with the Google account you want to connect

    For YouTube, this should be the Google account that owns your channel.

  3. Check Google's permission screen

    It should name MusicLaunch and list only the permissions described below. If you ever see a warning that the app isn't verified, stop and email hello@musiclaunchapp.com instead of continuing.

  4. Approve the requested permissions

    Gmail: send email on your behalf, plus your name and email address so the app can show which account is connected. YouTube: view your channel and upload videos. We don't read your inbox, change your settings, or delete anything.

  5. Browser returns to MusicLaunch automatically

    Account shows as Connected.

Sending from another address

Every window that sends through Gmail has a From line: the Email window (Contacts, Local Scene, Collaborators), New and Edit Submission, the Sync Licensing pitch email, and the Email button on a full-size photo (Gear, Media Hub and other pictures). With no other addresses it shows your main Gmail address. If you also send from another address (for example, one at your band's own domain), click "+ Add another address" next to From, type it and click Save address: it is added to the From menu there and from then on. You can also add and remove addresses in Settings → Gmail Integration (up to 10).

Gmail only sends from an address you've already added in Gmail's own settings (Settings → Accounts and Import, or Accounts on a work account → "Send mail as"); for any other address it quietly sends from your main one. Google's help page "Send emails from a different address or alias" shows how to add one; the form next to From links to it. MusicLaunch can't check Gmail's list for you (that would need a much wider Google permission than "send email"), so add the address in Gmail first.

Each profile keeps its own list of addresses, the same way each profile connects its own Gmail account. A follow-up sequence sends every email from the same address as its pitch: the From you picked for the pitch, or, for a pitch that already went out, the address it went out from (including a pitch you send yourself while the sequence is waiting to email it).

Each address also has a "Name people see": the name inboxes show next to it. You set it in Settings → Gmail Integration, and a name you type there is used exactly as you typed it. With no name typed, your main address shows the artist name of the campaign the email is for (a pitch or a sequence linked to a campaign, or a window open on one), or else your profile's name, or no name at all while the profile is still called "Default". Any other address shows no name until you type one, because it often belongs to a manager or a label. Removing an address keeps its name, so a sequence still sending from it keeps it too, and it comes back if you add the address again. In Settings you also pick the Default address every new email and sequence starts From; you can still choose another for one email. For an extra address, Gmail may show the name saved for it in Gmail → Settings → Accounts → "Send mail as" instead, so if a test email shows the wrong name, set it there too.

Why YouTube needs upload + readonly

youtube.upload lets MusicLaunch upload videos to your channel (they arrive as Unlisted; you make them Public in YouTube Studio). youtube.readonly lets us fetch your channel stats (subscriber count, video count, recent video performance) for the Performance dashboard. Both are necessary for the full feature set — but you can disconnect anytime.

These guides are also built into MusicLaunch under Help. Still stuck? Email hello@musiclaunchapp.com and we'll help.

All help articles This guide as plain text (Markdown)