Documentation structure for LLMs (llms.txt)
CircleCI Logo

Create an organization

10 days ago
Cloud

This guide covers creating a new organization in CircleCI. An organization is the top-level container for your team’s projects. It also holds the users, permissions, settings, and billing shared across those projects.

The following organization types are available:

  • circleci: This org type lets you connect to GitHub, GitLab, Bitbucket Data Center, or Cursor Origin (beta).

  • github: This org type is created automatically when you log in using your GitHub login.

  • bitbucket: This org type is created automatically when you log in using your Bitbucket login.

For a guide to organization types, see the Users, Organizations, and Integrations Guide.

Create a circleci organization

To create a circleci organization, follow these steps:

  1. Navigate to your user homepage in the CircleCI web app.

  2. Select the + Create organization button.

  3. Give your organization a name and select Let’s Go.

A new circleci organization is not yet connected to a VCS provider. Connect it, then invite your team and create a project:

Create a github organization

CircleCI creates a github organization when you log in using your social GitHub login. github organizations use an OAuth app connection with CircleCI. If you have logged in to CircleCI using a method other than your GitHub login, you can still create a github organization by following these steps:

  1. Navigate to your User settings page.

  2. Select Account Integrations from the sidebar.

  3. At the bottom of the page, select the link that reads Received instructions from the CircleCI Support team to authorize a GitHub OAuth app?.

  4. Follow the instructions to create a github organization.

Once CircleCI creates your github organization, you can invite your team and set up projects:

Create a bitbucket organization

CircleCI creates a bitbucket organization when you log in using your social Bitbucket login. bitbucket organizations use an OAuth app connection with CircleCI. If you have logged in to CircleCI using a method other than your Bitbucket login, you can still create a bitbucket organization by following these steps:

  1. Navigate to your User settings page.

  2. Select the Account Integrations from the sidebar.

  3. Select Connect next to Bitbucket.

  4. Follow the instructions to authorize the Bitbucket OAuth app.

Once CircleCI creates your bitbucket organization, you can invite your team and set up projects: