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.

Organizations provide centralized governance through access control and enterprise constraints. Access control manages who can perform actions, while enterprise constraints let organizations restrict HCP Product usage for cost control and compliance.

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

Organization owners can delete their HCP organization directly in the HCP Portal. Before you can delete an organization, you must resolve all outstanding items in the deletion checklist.

Requirements

You must have the owner role in the organization to complete this workflow.

Review the deletion checklist

Review the deletion checklist to verify that your organization is ready to be deleted. You must complete the requirements specified in the deletion checklist to proceed. To access the deletion checklist:

1. Log into HCP and open the Organization dashboard.
2. Click Manage organization, then select Organization settings.
3. Click Manage, then select Deletion checklist.

The checklist groups requirements into four categories:

• Billing: Confirms there are no active contracts, unpaid invoices, or billable resources that would block deletion.
  • When you delete an organization, HCP generates a final invoice for any outstanding charges, collects any remaining balance, and sends a receipt to the billing contact email on file.
• IAM: Confirms that users, groups, service principals, SSO, and SCIM are removed or disabled.
• Infragraph: Confirms there are no active Infragraph connections. Refer to the Infragraph documentation for more information.
• Resources: Confirms that no project resources remain and that the organization has only one project.

Each requirement displays a status of Done, Not Applicable or To Do. When all requirements are met, the page displays an Eligible for deletion: Yes banner and the Delete organization button becomes active. For any To Do items, click the ellipsis (...) and select the provided action to resolve the requirement.

Delete your organization

After the checklist states your organization is Eligible for deletion: Yes follow these steps:

1. On the Deletion checklist page, click Delete organization.
2. In the Delete organization? confirmation modal, review the warning that this action cannot be undone.
3. In the Confirm delete field, type DELETE using all capital letters.
4. Click Delete.

After successful deletion, HCP redirects you to the organization list at portal.cloud.hashicorp.com/orgs. All organization owners receive an email confirming the deletion.

If you need help or have questions about the process please contact HCP Support.