Skip to content
Help centre

GitHub

Link repositories to projects and pull requests to tasks, get notified when pull requests open or merge, and move tasks to done on merge.

Connect GitHub to link a repository to each project and pull requests to tasks. When a linked pull request opens or merges, the people on the task are notified, and a merged pull request moves its task to done.

What you need first

  • A GitHub account with access to your agency's repositories.
  • Owner or admin access in OpsDash to connect it.
  • GitHub credentials for your OpsDash. If the GitHub card asks you to Configure credentials, create a GitHub OAuth app, add the redirect URI shown on the card, and paste its Client ID and Client Secret.

Connect

  1. Go to Settings › Integrations and choose Connect on GitHub.
  2. Approve access in GitHub. OpsDash asks to read your repositories and organisations.
  3. On Settings › Integrations › GitHub, choose Test connection.

Open the project's Settings › Integrations and, under GitHub Repository, choose from your repositories, or type owner/repo (or paste its github.com address; this works before GitHub is connected). Unlink removes it.

In the task panel, under Pull request, choose Link PR and paste the pull request's address. Link more than one with Link another PR.

Webhooks: notifications and moving tasks

So OpsDash hears when pull requests open or merge, add a webhook in each repository:

  1. In GitHub, open the repository's Settings › Webhooks › Add webhook.
  2. Paste the payload URL shown on OpsDash's GitHub page.
  3. Set the content type to application/json.
  4. Set the secret to your OpsDash's GitHub webhook secret (it's set by whoever runs your OpsDash; on opsdash.io, ask support).
  5. Choose Let me select individual events and tick Pull requests.

Then, for tasks linked to a pull request in that repository:

  • the people on the task get a notification when it's opened, closed or merged,
  • a merged pull request moves the task to the project's done status.

The Sync log on OpsDash's GitHub page shows recent webhook activity.

Troubleshooting

  • The task didn't move on merge: check the pull request is linked on the task, the repository matches the project's, and the webhook shows a successful delivery in GitHub.
  • Webhook deliveries fail with 401: the secret doesn't match.
  • "GitHub isn't connected" in a project: connect it in Settings › Integrations. If it stopped working, Test connection, and reconnect if GitHub still refuses.

These open in OpsDash. You’ll be asked to sign in first if you aren’t already.