GitHub Issues

Approve Jamdesk right away:

1. Click grant Jamdesk access on GitHub under the organization picker (or go to GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. Under Organization access, click Grant next to your organization
3. Back in the Jamdesk setup flow, click refresh the list. Your organization appears right away

Members (not owners) see a Request button instead. It sends an approval request to your org admins.

Send your admins an approval request:

1. Go to GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. Under Organization access, click Request next to your organization. This notifies your org admins
3. An admin approves it in the org's Settings → Third-party access → OAuth application policy (pending requests show an Approve button)
4. Return to the Jamdesk setup flow and click refresh the list. Your organization should now appear

See GitHub's guide on approving OAuth apps for your organization for detailed steps.

Pick your personal account during setup to skip admin approval. Transfer the repo to your org afterward:

1. Complete the Jamdesk setup using your personal account
2. Go to the created repository on GitHub
3. Open Settings → General → Danger Zone
4. Click Transfer and select your organization as the destination
5. In Jamdesk, disconnect and reconnect the repository from your project's Settings page

This doesn't work if your company manages your GitHub account. See company-managed GitHub accounts instead.

1. Ask an enterprise owner to create an organization from the Organizations tab of your enterprise. Ask them to let you create repos in it.
2. Transfer your docs repo into it. In the repo, go to Settings, click Transfer at the bottom, and pick the new organization.
3. In Jamdesk, click Connect an existing repository (or Install GitHub App in project settings). On GitHub, pick the organization, choose Only select repositories, select your repo, and install.

If GitHub shows Request instead of Install, an organization owner gets an email to approve it. Click the Jamdesk button again after they do.

Use this when your company can't add an organization. Check with your GitHub admin first. The docs will live outside your company's GitHub.

1. In a private browser window, sign in to GitHub with a personal account (or create one).
2. Create an empty private repo on that account.
3. Push a copy of your docs to it. GitHub can't transfer repos out of a managed enterprise.

git remote set-url origin https://jsmith@github.com/jsmith/product-docs.git
git push -u origin main

Keep jsmith@ in the URL so Git asks for your personal account's login.

4. In Jamdesk, click Connect an existing repository (or Install GitHub App in project settings), install Jamdesk on your personal account, and pick the repo.

Managed accounts can't push to repos outside your enterprise. Every docs editor needs a personal GitHub account. Add them to the repo as collaborators.

1. Go to GitHub → Settings → Applications → Jamdesk
2. Verify the repository has access granted
3. Click Configure to add more repositories

For organization repos:

1. An org admin must approve Jamdesk
2. Go to org settings → Third-party access
3. Approve Jamdesk's access request

Private repos require GitHub authorization. Re-authorize Jamdesk if needed.