Organizations

This page describes how to create and manage an organization in HashiCorp Cloud Platform (HCP).

Introduction

An organization is a top-level entity in HCP for organizing resources. It contains one or more HCP projects, which separate access to resources such as HashiCorp Virtual Networks (HVN) according to user permissions. An organization can have up to 100 projects.

Users can be a member of multiple organizations, and organizations can have a maximum of 3 users with the owner role. Users with the owner role can add and remove other organization owners over time, but organizations require at least one owner at all times.

You cannot create an organization if you are already the owner of an existing organization.

Create an organization

When you sign up for a HashiCorp Cloud Platform (HCP) account, the HCP Portal takes you to a guided worfklow.

1. Select the type of organization you want to create, either Business or Personal.
2. Specify the name, address, and country of origin for your organization. The name must be unique. If another organization is already using the name, you will recieve a prompt to choose a different one.
3. Accept the terms and conditions. Then click Create organization.

After you create your organization, you can invite users to your organization and start creating HCP resources.

Locate the organization ID

To locate the organization ID:

1. At the top, click the dropdown to open the organization and project selector. Select View all organizations.
2. Click the name of the organization.
3. From the Organization dashboard, click Organization settings.
4. Click the clipboard icon next to the ID to copy the Organization ID.

Find organization owners

An organization can have one to three users with the owner role. Owners can change, but there must always be at least one owner per organization.

To find the organization's current owners, perform the following steps:

1. At the top, click the dropdown to open the organization and project selector. Select View all organizations.
2. Click the name of the organization.
3. From the Organization dashboard, click Organization settings.
4. To copy the Organization ID, click the clipboard icon next to the ID.

Manage an organization

To change your organization's name:

1. At the top, click the dropdown to open the organization and project selector. Select View all organizations.
2. Click the name of the organization.
3. From the Organization dashboard, click Organization settings.
4. At the top-right, click Manage, and then click Rename organization.
5. Enter a new organization name. The name must contain between 3 and 40 characters, and it may include ASCII letters, numbers, hyphens, and underscores. The name must be unique. If another organization is already using the name, you will receive a prompt to choose a different one.
6. Click Save.

You may encounter an Organization name update failed error when managing an HCP organization from an HCP Terraform workspace. Refresh the organization's settings page from HCP Terraform, and the name change should take effect.

Delete an organization

Only HashiCorp Support can delete an organization. Before you contact Support, organization owners can complete a deletion checklist to ensure that all of the prerequisites are met. Completing the checklist helps prevent delays and reduces follow-up questions from Support.

You must meet each of the requirements for deletion in the following categories:

• Billing: The organization must not be part of an active Flex or annual contract. It cannot have unpaid invoices or active billable resources.
• Identity & Access Management (IAM): The organization cannot have any user groups, service principals, or active users aside from the requesting owner. It must have SSO disabled.
• Resources: You cannot have more than one project or any active project resources. To access the deletion checklist:

1. From the Organization dashboard, click Organization settings.

2. From the Manage menu, select Deletion checklist.

   The Deletion checklist page displays the requirements for deleting an organization. It displays a status of Done, Not Applicable or To Do for each requirement.

3. For any To Do items, click the ellipsis (...) and select the provided action to view details and resolve the blocking issue.

4. Once the checklist states that the organization is Eligible for deletion, contact HashiCorp Support to proceed with the deletion.