Skip to main content

​
About the GitHub connector

The GitHub connector lets your Base44 app securely access GitHub data using OAuth. Use it to build pull request and issue dashboards, automate issue creation, generate release notes, and sync repository activity into your app. The GitHub connection is shared at the app level. When you connect GitHub, you authorize one GitHub account for that app. Everyone who can edit the app uses the same GitHub connection and sees the same GitHub-powered data inside the app.
Basegithubconnector
Important: Connectors are app-level, shared connections. Do not use the GitHub connector if each person using your app needs to connect their own GitHub account. For per-person GitHub login, build a custom OAuth flow with backend functions.
Before you begin: You need a Builder plan or higher to use connectors in your app.

​
GitHub use cases and prompts

Use the GitHub connector to track engineering work, keep stakeholders updated, and connect code workflows to the rest of your tools.
Build dashboards that list pull requests, show their status, and surface what needs review. You can also create views for recent commits, contributors, and repository activity.Example prompts:
Turn GitHub issues into structured queues inside your app. Track priorities, assignees, labels, and aging issues, and keep a clear view of what is blocked or overdue.Example prompts:
Trigger GitHub actions from events in your app, such as creating an issue when a bug is reported, or opening a tracking issue when an incident is created.Example prompts:
Sync merged pull requests and commits into a changelog, or generate release notes automatically from GitHub activity.Example prompts:
Connect GitHub to Slack, Gmail, BigQuery, Notion, or CRMs to route engineering updates where teams work.Example prompts:
When describing multi-tool flows in the AI chat, be explicit about which GitHub event should trigger the action and what details to include (repo, issue/PR number, title, labels, link).

​
Connecting GitHub to your app

Use the AI chat to connect to GitHub, or connect using a pre-made prompt from your app dashboard.

​
Using the AI chat

  1. Go to your app editor.
  2. Describe what you want to do with GitHub in the AI chat, for example:
    • Connect to GitHub and show all open pull requests for org/repo that are waiting for review.
    • Create a GitHub issue when a new bug is reported in this app.
  3. Review the Action required and Required permissions in the side panel.
  4. Click Connect to GitHub.
  5. In the GitHub window that opens:
    1. Sign in to the GitHub account you want to connect.
    2. Review the requested permissions and click Authorize.
  6. Return to the editor and let the AI finish creating the GitHub-powered pages, tables, and flows.
Connectinggithub

​
From the app dashboard

  1. Click Dashboard in your app editor.
  2. Click Integrations.
  3. Click the Browse tab.
  4. Find GitHub and click Use.
  5. Select the pre-made prompt you want to add to the AI chat.
  6. In the AI chat, review the Action required and Required permissions.
  7. Click Connect to GitHub and complete the authorization flow.
  8. Return to the editor and let the AI finish creating the GitHub-powered flows.
Githubindashboard
Start with a simple read-only flow (like listing open pull requests) to confirm the connection works. Then add write actions like creating issues.
If you click Reject or close the authorization window, the connector is not added. You can run the connection flow again from the AI chat or from Integrations → Browse.

​
Managing your GitHub connection

You can review and manage the GitHub connector for each app from the app’s dashboard. To manage your GitHub connector:
  1. Go to your app’s dashboard.
  2. Click Integrations.
  3. Click the My integrations tab.
  4. Find the GitHub connector.
  5. Choose what you want to do:
    • View access: See which permissions GitHub currently has in this app.
    • More actions: Reconnect, switch, disconnect, or remove the connected GitHub account. Available actions depend on the connector status.
App dashboard showing the GitHub connector options in the My integrations tab

​
Reconnecting GitHub

Reconnect GitHub if the connected account is disconnected, access is revoked in GitHub, or GitHub asks you to authorize access again. To reconnect GitHub:
  1. Go to your app’s dashboard.
  2. Click Integrations.
  3. Click the My integrations tab.
  4. Find the GitHub connector.
  5. Click the More actions icon on the GitHub connector and select Reconnect.
  6. Review the requested permissions and approve access.

​
GitHub scopes and permissions

When you connect GitHub, the connector requests permissions through GitHub’s OAuth authorization flow. The exact permissions you see depend on what your app is trying to build or run.

GitHub permissions

Always review the permissions shown in the GitHub authorization window before approving access.Example permissions you may see:
  • repo: Full access to repositories the connected account can access.
  • read:user: Read basic profile information for the connected account.
  • user:email: Read email addresses for the connected account.
GitHub permissions may change depending on the flows you build. The authorization window always shows the current access being requested.

​
FAQs

No. Each app uses one shared GitHub account. To use multiple GitHub accounts, create separate apps or build a custom OAuth flow with backend functions.
No. Connectors are app-level. When you connect GitHub, you connect a single GitHub account that all flows in the app use.To let each person using your app connect their own GitHub account, you need to build a custom OAuth flow with backend functions and the GitHub API, including per-user token storage and refresh.
  1. Go to your app’s dashboard.
  2. Click Integrations.
  3. Click the My integrations tab.
  4. Click the More actions icon on the GitHub connector and select Switch account.
  5. Complete the GitHub authorization flow for the new account.
Access to private repositories depends on what you approved during authorization and which repositories your connected GitHub account can access. Reconnect GitHub and review the permissions shown in the authorization window to make sure the connector is authorized for the repositories you need.To reconnect, see reconnecting GitHub.
Yes, if the flow you build requires write permissions and you approve them during authorization. Always review the permissions shown in the connection flow before approving access.