V12 Docs

Creating an organization

Set up a workspace and link a GitHub organization.

Open the org switcher and choose Create organization.

Pick a GitHub organization where the V12 GitHub app is installed (or install it during the flow). V12 creates the workspace tied to it. After linking:

  • Membership tracks the GitHub org. Once a teammate has signed in to V12 with GitHub, adding or removing them in GitHub does the same in V12. No separate invites needed.
  • Repos owned by that GitHub org are available to anyone in the V12 organization without per-person GitHub re-auth.

Pick this option if your team already manages access via GitHub.

Create organization step prompting you to connect a GitHub organization where the V12 GitHub app is installed.

Skip GitHub and invite manually

If you don't have a shared GitHub organization, skip the GitHub step and invite people by email. You can link a GitHub organization later from Settings → Organization without losing data.

Changing or reconnecting the GitHub organization

To link a GitHub organization, or change which one is linked, go to Settings → Organization → GitHub organization.

Linking requires:

  1. A connected GitHub account on your V12 profile (Settings → Account).
  2. The V12 GitHub app installed on the target GitHub organization. V12 walks you through the install if it isn't there.
  3. Owner permission on the GitHub organization.

The app requests read access to repository contents. It does not request write access. If the app is later removed from GitHub, V12 shows a reinstall prompt and GitHub-backed runs stop working until it's restored.