---
title: "Repository connections"
url: https://docs.corefinity.com/guides/organisation/developers/repository-connections
type: guide
last_updated: 2026-11-13
feature: deployment-connections
related:
  - https://docs.corefinity.com/api/reference/organisation/list-company-deployment-connections.md
  - https://docs.corefinity.com/api/reference/organisation/delete-company-deployment-connection.md
  - https://docs.corefinity.com/api/reference/organisation/list-own-deployment-connections.md
  - https://docs.corefinity.com/api/reference/organisation/delete-own-deployment-connection.md
  - https://docs.corefinity.com/mcp/tools/corestack_company_deployment_connections_list.md
  - https://docs.corefinity.com/mcp/tools/corestack_company_deployment_connection_delete.md
---
# Repository connections

Connect your organisation's GitHub, GitLab or Bitbucket account so its sites can deploy from Git, and disconnect one that is no longer used.

## Before you start

- You are an owner, or your role has **Manage Company Deployment Sources**. Only an owner can disconnect an account.
- An agency connects an account for a client on the client's organisation page.
- The account belongs to the organisation, not to one person.

## Connect GitHub, GitLab or Bitbucket

1. **Open Deployments**

   Go to **Organisation › Organisations**, choose the organisation, then **Deployments** under **Developers**.

   _Screenshot: The organisation page's menu with Deployments ringed under Developers, and the Repository connections card: GitHub with one connected account, northwind-digital, and GitLab, Bitbucket and Self-hosted GitLab each Not connected with a Connect button._

2. **Sign in to the provider**

   Under **Repository connections**, choose **Connect** beside **GitHub**, **GitLab** or **Bitbucket**. Sign in there and approve access.

The account is listed under its provider as **Connected**. A provider can hold several accounts: choose **Connect** again to add another.

## Connect your own GitLab server

1. **Enter the server and a token**

   Choose **Connect** beside **Self-hosted GitLab**. Enter the **Server address**, starting `https://`, and a **Personal access token** with the `api` scope, then choose **Connect**.

   _Screenshot: The Connect your GitLab server dialog with the fields Server address, filled with an example address, and Personal access token, and the buttons Cancel and Connect._

The token is stored encrypted and never shown again.

## Reconnect an account

1. **Sign in again**

   Choose **Reconnect** on an account marked **Needs re-authorising**, and sign in to the provider again. For your own GitLab server, enter a new token.

## Disconnect an account

1. **Move the environments that use it**

   In each site's **Deployments** section, choose another connection for every environment that deploys through the account. An account still in use cannot be disconnected.

2. **Disconnect**

   Choose **Disconnect…** on the account's row, then **Disconnect**.

   _Screenshot: The Disconnect northwind-archive? dialog, saying the organisation stops reading repositories through this GitHub account, with the buttons Cancel and Disconnect._

Environments keep their deployed code.

## Automate this

**API:** [List your company's repository connections](https://docs.corefinity.com/api/reference/organisation/list-own-deployment-connections.md), scope `read`

```bash
curl https://manage.corefinity.com/api/company/deployment-connections \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
```

**MCP:** [`corestack_company_deployment_connections_list`](https://docs.corefinity.com/mcp/tools/corestack_company_deployment_connections_list.md), scope `read`

```json
{
  "name": "corestack_company_deployment_connections_list",
  "arguments": {}
}
```

**Control Panel:** Organisation › Organisations › your organisation › Developers › Deployments ([https://manage.corefinity.com/go/deployment-connections](https://manage.corefinity.com/go/deployment-connections))

## Related

- [Connect a repository](/guides/sites/code-and-deployments/connect-a-repository): Switch a site to Git deployments.
- [Deployment templates](/guides/sites/code-and-deployments/deployment-templates): Set the stages for a platform's sites.
- [Custom roles and permissions](/guides/organisation/people/custom-roles-and-permissions): Create a role and choose its permissions.
