# Onboarding a new organization

To perform this procedure, you must be an admin of your enterprise.

To onboard a new organization to your enterprise.

1. Create your organization in SonarQube Cloud by importing the DevOps platform organization and select the Free plan. See:
   * [Importing GitHub organization](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-github-organization.md)
   * [Importing Bitbucket workspace](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-bitbucket-workspace.md)
   * [Importing GitLab group](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-gitlab-group.md)
   * [Importing Azure DevOps organization](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-azure-devops-organization.md)
2. Add the organization to the enterprise:
   * Retrieve your enterprise. See [Retrieving and viewing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md) for more details.
   * Go to **Administration** > **Organizations** and select **Add organization**.

<figure><img src="/files/OoUchZdtkaC624Jq3PCP" alt="Add an organization to your enterprise"><figcaption></figcaption></figure>

3. Optionally, allocate an individual LOC limit to the organization. See [Managing the lines of code within your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise.md#allocating-loc-limit).
4. Manage the organization's user groups (see [Managing user groups](/sonarqube-cloud/administering-sonarcloud/managing-organization/users-and-permissions/user-groups.md) for more details):
   * In an SSO-enabled enterprise:
     * With SCIM provisioning: [Map the SCIM groups](/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/set-up-scim.md#map-groups) to the new organization.
     * Without SCIM: Define the user groups in your organization as described in [Complete SSO setup](/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/complete-setup.md#if-using-jit).
   * If you don't use SSO in your enterprise:
     * Define the users and/or groups that can create projects in the organization. See [Managing organization permissions](/sonarqube-cloud/administering-sonarcloud/managing-organization/users-and-permissions/organization-permissions.md) for more information.
     * Verify the default permissions on new projects. See [Using permission templates](/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/manage-project-permissions/templates.md) for more details.
5. Set analysis configurations at the organization level. See [Performing global analysis setup](/sonarqube-cloud/administering-sonarcloud/managing-organization/setting-config-at-org-level.md).
6. Authorized organization members can now create projects or portfolios.

## Related pages <a href="#related-pages" id="related-pages"></a>

* [Setting up your enterprise](/sonarqube-cloud/getting-started-with-enterprise/setting-up-your-enterprise.md)\
  View the different steps necessary to create and configure an enterprise.
* [Viewing usage information](/sonarqube-cloud/getting-started-with-enterprise/viewing-billing-usage-info.md)
* [Managing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/onboarding-new-org.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
