Join teammates on CircleCI

Language Icon 1 month ago · 5 min read
Cloud
Contribute Go to Code

After setting up an organization in CircleCI, ensure your whole team get access.

Prerequisites

  • A CircleCI account connected to your code. You can sign up for free.

  • At least one project created in your organization. See the Create a project page for instructions.

Find your team

After creating an account, you can join an existing CircleCI organization using the Find Your Team dropdown menu in the Join Your Teammates card on the homepage.

Screenshot showing the welcome screen with the find your team menu expanded

To join an organization, there are three options:

These options are also available at any time using the Join Organization menu on your homepage. Steps for each option are outlined in the following sections.

Join an existing CircleCI organization via an invite

  1. Reach out to your organization admin to request an invite

  2. Your organization admin will need to follow the steps below in the Invite teammates to join your organization section to send you an email invite. Once you receive your invitation, follow the link to log in and join your organization

Join an existing CircleCI organization with a GitHub OAuth app integration

  1. Select "Search via GitHub" from the Find Your Team dropdown

  2. Authorize the GitHub OAuth app for read access to your GitHub organization membership

  3. After authorization, you will be redirected to CircleCI where we will list all matching CircleCI organizations that you are eligible to join. Select Join Organizations to successfully complete joining these organizations in CircleCI.

    If you do not see the organization you would like to join listed, you will need to receive an invite to join from an organization admin. Reach out to your admin to request an invite, and send them a link to this help doc for reference.

Join an existing CircleCI organization with a Bitbucket Cloud integration

  1. Select "Search via Bitbucket" from the Find Your Team dropdown to be redirected to Bitbucket Cloud.

  2. Enter your Bitbucket Cloud credentials to authorize CircleCI to your Bitbucket Cloud account.

  3. After authorization, you will be redirected back to CircleCI and will be added to your organization.

Invite teammates to join your organization

The steps in this section show how an org admin can invite teammates to join their organization.

To find out which GitHub integration type you have, check your Organization slug at Organization settings  Overview. OAuth authenticated orgs are structured as follows:

  • github/<your-org-name> or gh/<your-org-name>

  • bitbucket/<your-org-name> or bb/<your-org-name>

An organization slug for a GitHub App integration is in the following format:

  • circleci/<UID>

  • GitHub App GitLab Bitbucket Data Center

  • GitHub OAuth Bitbucket Cloud

  1. In the CircleCI web app, select your org from the org cards on your user homepage.

  2. Navigate to Organization Settings  People, then select Invite.

  3. To send out email invites, enter your team members' email addresses. Multiple emails can be separated by a space. Then, assign their role in your CircleCI organization. If you need to assign different roles to different team members, add team members in the Invite form based on role.

  4. Once they join your org, you can then also assign each team member a role on an individual project level. See the Manage roles and permissions page for more details.

Navigate to Organization Settings
  1. In the CircleCI web app, select your org from the org cards on your user homepage.

  2. Select Organization Setting from the sidebar and select People.

  3. Select Copy Invite Link — an invite message is now copied to your clipboard.

  4. Past the invite message to your teammates via email or whatever method you prefer.

Navigate to Organization Settings