Skip to main content
When you start a run from GitHub, GitLab, Bitbucket, Jira, or Linear, Upsun Dispatch receives your account on that tool. It does not know which Upsun Dispatch user owns that account until you connect it to your profile. With your accounts connected, Upsun Dispatch can:
  • assign the pull or merge request that Issue to code opens to you, the person who started the run, and
  • record you as the person who started each run.
A connected account only tells Upsun Dispatch who you are. It gives you no access. Your Upsun Dispatch role and your access on each tool still decide what you can do.

Which accounts to connect

To assign a pull or merge request to you, Upsun Dispatch needs your account on the tool where you started the run and on the host where the pull or merge request opens. If an account is missing, Upsun Dispatch opens the pull or merge request with no assignee. For a run started on Jira or Linear, Upsun Dispatch sets an assignee only when the repository or project is private. An assignee would show who asked for the work, so a public repository, or a GitLab project with internal visibility, gets no assignee.

Connect an account

You connect GitHub, GitLab, Bitbucket, Jira, and Linear accounts with a one-time code. You post the code as a comment from the account you want to connect, then confirm it on your profile.
1

Open your profile

In the Upsun Dispatch console, open the account menu and select My profile. Find the Connected accounts card.
2

Get a one-time code

Select Connect an account, then choose the provider. For GitLab, choose the instance. For Linear, choose the workspace. The list shows only the connections of your organizations. Select Get code.The card shows the code and the exact comment to post. The code expires in 10 minutes.
3

Post the comment

Signed in to the account you want to connect, post the comment the card shows:On Linear, type @ and pick the Upsun Dispatch app from the mention list, then paste the rest of the comment. A typed or pasted name is not a mention, so Linear does not send the comment to Upsun Dispatch.Upsun Dispatch replies to your comment and asks you to confirm the account on your profile.
4

Confirm the account

On your profile, the Waiting for confirmation section shows the account that posted your code. If the account is yours, select Confirm. If it is not, select Reject. You have 10 minutes to confirm.The account then shows in the Connected accounts list.
Anyone who sees your code can post it. The comment alone does not connect an account: only you can confirm it on your profile. If two different accounts post the same code, the code stops working. Get a new code and post it again.

Permissions on the provider

To post the code, the account needs this access:
  • GitLab: the Developer role or higher on the project.
  • GitHub and Bitbucket: write access to the repository.
  • Jira and Linear: no specific role.

One account per connection

You can connect one account for each connection:
  • one GitHub account,
  • one account on each GitLab instance (GitLab.com and a self-managed instance count as two),
  • one Bitbucket account,
  • one Jira account for all Jira sites, and
  • one account in each Linear workspace.
To connect a different account on the same connection, disconnect the current one first.

Disconnect an account

In the Connected accounts card, select Disconnect next to the account, then select Disconnect account. You can connect it again later with a new code.

Troubleshooting

Upsun Dispatch replies to every comment that carries a code. The reply never repeats the code.

Code not accepted

The code is unknown, expired, or already used, or another account posted it first. You also get this reply when you post the code on a GitLab instance or Linear workspace other than the one you chose. Get a new code on your profile and post it where you chose.

The code was not used

Upsun Dispatch could not use the code. Get a new code and post it again.

The reply asks for a role or write access

Your account does not have the access that Permissions on the provider lists on this project or repository. Post a new code in a project or repository where you have that access.

The reply says your role or access cannot be checked

Upsun Dispatch cannot read your role or access on this project or repository. Post a new code in another project or repository.

The card is missing, or says you can’t connect an account on a provider

If your profile has no Connected accounts card, none of your organizations has connected a tool yet. If the card says you can’t connect an account on a provider, none of your organizations has connected that tool. Ask a person who manages the integrations of your organization to connect it, then get a code. See Integrations.

A provider or a connection is disabled

You already have a connected account on it. Disconnect that account first to connect another one.
Last modified on November 16, 2026