Skip to main content
Connect your app to GitHub to track pull requests, work with issues, and follow repository activity, either from one shared account or from each person’s own GitHub account. This connector lets your app work with the GitHub API. To sync your app’s code with a GitHub repository, use Base Code instead.
You need a Builder plan or higher to use connectors in your app.

​
What you can do

Bring engineering work into your app’s workflows.

Track pull requests

Show which pull requests are open, who is reviewing them, and what is waiting, on a dashboard inside your app.

Work with issues

List and filter issues, and open a new one when something is reported in your app.

Follow repository activity

Bring commits, releases, and repository stats into the pages and reports your team reads.
Example prompts Describe the repository, what triggers the action, and any dynamic fields in the AI chat. For example:

​
Connecting GitHub

Connect GitHub so your app can read repository data and open issues.
You connect one account once, and everyone who uses your app shares that connection and its data.To add a shared GitHub connector:
  1. Click Connectors in your workspace sidebar.
  2. Click Add connector.
  3. Search for GitHub API, then click it.
  4. Select Shared connector, then click Next.
  5. Enter a Connection name.
  6. Under Who can access, select where the connection can be used. The default is Apps and Super agent.
  7. Under Permissions, select Read-only or Read & write. The default is Read-only.
  8. Click Add connector, then sign in with the GitHub account you want to share.

​
Scopes and permissions

Scopes control what your app can do in GitHub.
1

Shared connector

Under Permissions, select the access your app needs:
  • Read-only: Grants read:user and read:org, to read profile and organization data
  • Read & write: Adds repo, for full control of the repositories the connected account can access
2

App user connector

Nothing is selected under Scopes by default, so select what your app needs. Additional scopes is prefilled with:
  • read:user and read:org: Read profile and organization data
Access: Your app works with the repositories and organizations that the GitHub account authorizing the connection can access.

​
Using GitHub in a backend function

Once GitHub is connected, your backend functions can retrieve an access token and call the GitHub API directly. Base44 handles the OAuth flow and token storage.
  • For a shared connection, use getConnection() to retrieve the token.
  • For an app user connection, use getCurrentAppUserConnection() so each request uses the signed-in person’s token.

Shared connectors

Configure, deploy, and call a shared connection from a backend function.

App user connectors

Retrieve a per-user token and call the API as the signed-in person.