🐙

GitHub

Available

Connect your GitHub repositories with tapioca. Link commits, pull requests, and issues to tasks. Automate workflows with GitHub Actions integration.

What you can do

Link commits and PRs to tasks
Automatic task status updates from PR events
Import GitHub Issues as tapioca tasks
Two-way sync for linked issues
GitHub Actions workflow triggers
Branch and commit references in tasks
Code review tracking

Setup Instructions

1

Install the GitHub App

Install the tapioca GitHub App on your organization or repositories. Go to Settings → Integrations → GitHub and click "Install GitHub App".

2

Authorize repositories

Select which repositories tapioca can access. You can grant access to all repositories or select specific ones.

3

Map repositories to projects

Link GitHub repositories to tapioca projects. Commits and PRs will be associated with the correct project.

4

Configure automation

Set up automatic task status updates when PRs are opened, merged, or closed.

Configuration Reference

OptionTypeRequiredDescription
app_installation_idstringYesGitHub App installation ID
repository_mappingobjectNoMap repositories to projects
auto_link_commitsbooleanNoAuto-link commits mentioning task IDs
Default: true
import_issuesbooleanNoImport GitHub Issues as tasks
Default: false
pr_status_mappingobjectNoMap PR states to task statuses
sync_labelsbooleanNoSync labels between GitHub and tapioca
Default: false

Troubleshooting

Commits are not linking to tasks

Include the task ID in your commit message (e.g., "Fix bug TAP-123"). Ensure auto_link_commits is enabled.

GitHub App installation failed

Make sure you have admin permissions on the GitHub organization or repository.

PR events not updating tasks

Check that the GitHub App has the correct permissions and webhooks are being received.

Related Integrations

Need help with this integration?

Our team is here to help you get set up and running.