> ## Documentation Index > Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt > Use this file to discover all available pages before exploring further. # Workspaces > When you first sign up for Hightouch, or when your team needs an additional workspace, you'll use the workspace creation flow. This guide walks through when and how to create a workspace, what each field means, and common mistakes to avoid. > [!TIP] > > Before creating a new workspace, make sure you actually need one. For most > teams, a single production workspace is sufficient — Hightouch's [governance > controls](https://docs.hightouch.com/workspace-management/governance.md), including user groups, roles, > Spaces, and approval flows, let multiple teams share a workspace safely. See > [Do you need another workspace?](#do-you-need-another-workspace) below. ## Who should create workspaces Workspace creation is restricted to users who have **organization admin** privileges. In most companies, this is the [**IT or platform admin**](https://docs.hightouch.com/getting-started/it.md) — typically the person who also owns SSO configuration, billing, and user provisioning. If you're setting up Hightouch for the first time, the person who signs up becomes the first organization admin automatically. If your organization uses SSO, workspace creation may be further restricted — in that case, contact your IT team or Hightouch administrator. > [!TIP] > > If you see the message **"SSO users are not allowed to create workspaces"**, > your organization has disabled self-serve workspace creation. Reach out to > your platform admin to have them create the workspace on your behalf. ## First sign-in What you see when you first log in to Hightouch depends on whether your company already has an organization set up. ### New company If no one at your company has used Hightouch before, sign up at [app.hightouch.com](https://app.hightouch.com?from=docs) using Google, Microsoft, or email. ![The Hightouch sign-up screen with Google, Microsoft, and email options](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/sign-up.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=bab6a549a7e0fe61220b941a0fef5713) After signing up, you'll be prompted to: 1. **Create an organization** — this represents your company and is the container for billing, SSO, and user management. 2. **Create your first workspace** — using the form described below. After creating your workspace, the **Get started** checklist guides you through connecting a data source, adding destinations, and inviting teammates. ### Existing company If your company already has an organization and workspaces in Hightouch, you should **not** create a new organization. Instead: * Ask an existing admin to **invite you** to the appropriate workspace, or * Log in through your company's **SSO provider**, which will route you to the correct organization and workspace automatically. ![The Hightouch login screen with Google, Microsoft, email, and SSO options](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/login.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=e8d8cf5af3a52fd6aa6099ef872d63ff) > [!WARNING] > > If you were invited to Hightouch but land on the workspace creation screen > instead of your team's workspace, **stop and contact the person who invited > you**. Creating a new organization or workspace in this situation will result > in a duplicate that needs to be cleaned up. ## Workspace creation form The creation form has four fields: **Organization**, **Workspace name**, **Workspace slug**, and **Region**. ![The workspace creation form with fields for name, slug, region, cloud provider, and organization](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/create-workspace-form.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=6fffed551a0e49b27cc9278901bccb9f) ### Organization The **Organization** dropdown lets you select which organization the new workspace belongs to. * **New organization** — if you're the first person at your company signing up for Hightouch, select **New organization**. You'll provide your organization name (typically your company's legal or common name, such as "Acme Inc."), and Hightouch will create the organization and make you its first organization admin. * **Existing organization** — if your company already has an organization, select it from the dropdown. You'll only see organizations where you have permission to create workspaces. Most companies should have **exactly one** organization. Multiple organizations are only appropriate when you operate truly separate legal or identity domains — for example, a holding company with independent subsidiaries that don't share users, billing, or SSO configuration. > [!WARNING] > > If your company already uses Hightouch, do not select **New organization**. > This creates a duplicate organization that will need to be cleaned up. > Instead, ask an existing admin to invite you, or log in via SSO. ### Workspace name The name appears in the workspace switcher and helps your team identify the workspace. Choose something descriptive: * **Single workspace:** Your company name, or something like ` Production`. * **Production + sandbox:** ` Production` and ` Sandbox` (or `Playground`). * **Multiple workspaces:** Use a pattern that makes the distinction clear, such as ` – US` and ` – EU`, or `` and ``. You can change the workspace name later in **Settings → Workspace**. ![Workspace settings showing the workspace name, slug, billing organization, and region fields](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/workspace-change-name.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=0bed544363bc02873476aa20176bdbdc) ### Workspace URL/slug The slug becomes part of your workspace URL: `app.hightouch.com/`. It must be globally unique and is auto-generated from the workspace name. ![The workspace slug shown in the browser URL bar](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/workspace-slug-url.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=b5bad92f71c9e3000abe9406d1256248) > [!NOTE] > > Treat the slug as **permanent**. While workspace admins can technically update > it later in **Settings → Workspace**, changing the slug breaks all existing > bookmarked URLs, saved links, scripts, and integrations that reference the old > slug — and there is no automatic redirect. Choose carefully before submitting > the form. ### Region and cloud provider The region determines where Hightouch processes your data. You'll select both a **geographic region** (United States, European Union, Asia Pacific, or Middle East) and a **cloud provider** (AWS, Google Cloud, or Azure). The available cloud providers vary by region. When choosing a region: * **Prefer the region closest to your primary data warehouse** and your end users to reduce latency. * **Consider data residency requirements.** If compliance mandates that data stay within a specific jurisdiction, select a region in that jurisdiction. * **Check feature availability.** Not all features are available in every region. Refer to the [Regions](https://docs.hightouch.com/security/regions.md) documentation for a current compatibility matrix. > [!WARNING] > > Region cannot be changed after workspace creation. If you create a workspace > in the wrong region, you'll need to create a new workspace in the correct > region and migrate your configuration. > > [Contact support](#pylon-chat) > > > > if you need assistance. > [!NOTE] > > Some newer regions may be in limited availability. If the region you need > isn't visible in the dropdown, > > [contact Hightouch](#pylon-chat) > > > > to check availability and have our team help provision your workspace. ![A completed workspace creation form with name, slug, region, and cloud provider selected](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/create-workspace-form-filled.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=74c0d072a92145d34e18201e64b3293e) ## After creation Once your workspace is created, Hightouch presents a **Get started** checklist that walks you through initial setup: ![The Get started checklist shown after workspace creation](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/get-started-checklist.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=7a6d35aead6911c10e3e69d4a13fe38b) 1. **Invite teammates** — add collaborators so they can help configure the workspace. 2. **Set up storage bucket** *(Business tier only)* — bring your own S3, GCS, or Azure Blob Storage bucket for data-at-rest. This step only appears for Business tier workspaces. See [Storage](https://docs.hightouch.com/security/storage.md). 3. **Connect to your data warehouse** — set up access to your data source. See [Sources](https://docs.hightouch.com/sources/overview.md). 4. **Add destinations** — connect your marketing, sales, or other downstream tools. See [Destinations](https://docs.hightouch.com/destinations/overview.md). > [!NOTE] > > The exact steps shown may vary depending on your plan tier and workspace > configuration. ## Switching between workspaces If you have access to multiple workspaces, you can switch between them in two ways: * **Workspace switcher** — click the workspace name in the top-left corner of the sidebar to open the workspace dropdown, or press **S** then **W** anywhere in the app. You can also open the command bar with **Cmd+K** (Mac) / **Ctrl+K** (Windows) and type "Switch workspace." Search by name or slug and select the workspace you want. ![The workspace switcher dropdown in the sidebar](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/workspace-switcher-dropdown.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=929446cb6b62c4f7776fa16b94f84701) * **Direct URL** — navigate to a URL containing another workspace's slug (for example, `app.hightouch.com/other-workspace/syncs`). Hightouch will automatically switch your active workspace to match. ## Deleting a workspace There is no self-serve option to delete a workspace. You can find the deletion option in **Settings → Workspace**, but it routes you to Hightouch support. ![The Delete workspace section in Workspace settings](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/workspace-management/creation/workspace-delete.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=ad057a49de9fa9ad530a5a9168c1ad1a) If you need to remove a workspace — for example, one created by mistake — [contact Hightouch support](#pylon-chat). Before submitting your request, remove or disconnect all sources, destinations, syncs, and other resources from the workspace. All current organization or workspace admins will need to approve the deletion. ## Do you need another workspace? Before creating an additional workspace, consider whether [Environments](https://docs.hightouch.com/workspace-management/environments.md) or other governance controls would be a better fit. **Use Environments when:** * You need dev / staging / production promotion for the same data and teams. * You want change control and approval flows without hard security isolation. **Create a separate workspace when:** * You have strict isolation requirements — regulatory, regional, or business-unit-level — where sources, destinations, and data must not be visible across boundaries. * You need fully separate tenants under the same commercial relationship, such as independent subsidiaries. | Consideration | Environments | Separate workspaces | | :- | :- | :- | | Shared sources and destinations | Yes | No — each workspace has its own | | Shared user roster | Yes | No — managed separately per workspace | | Approval flows | Yes | Yes, but independent per workspace | | Data isolation | Logical (same workspace) | Physical (nothing shared) | | Typical use case | Dev → Staging → Prod | US region vs EU region | For more on structuring your organization, see [Governance best practices](https://docs.hightouch.com/workspace-management/governance.md). ## Troubleshooting ### I was invited but see the create-workspace screen This usually means the invitation didn't link you to the correct organization or workspace. Don't create a new organization — instead, contact the person who invited you and ask them to re-send the invite or check that your account is correctly associated with their organization. ### I accidentally created a duplicate organization If you signed up directly instead of using an invitation or SSO, you may have created a second organization for your company. [Contact support](#pylon-chat) to consolidate your organizations. ### I need to change my workspace region Region cannot be changed self-serve after creation. [Contact Hightouch support](#pylon-chat) to plan a migration. Before you reach out, be aware of the following: * **Brief outage required.** The migration involves a short period of downtime for the affected workspace. Schedule it during low-traffic hours. * **Tunnels must be recreated.** Existing [SSH tunnels](https://docs.hightouch.com/security/ssh-tunneling.md) cannot be migrated between regions. You'll need to set up new tunnels in the target region after the migration. * **IP allowlists need updating.** If your sources or destinations are behind a firewall that allowlists Hightouch's [IP addresses](https://docs.hightouch.com/security/networking#ip-addresses), add the new region's IP range before the migration and remove the old range afterward. * **Sync history and debugger data.** If you use [self-hosted storage](https://docs.hightouch.com/security/storage.md#self-hosted-storage) or the [Lightning sync engine](https://docs.hightouch.com/syncs/lightning-sync-engine.md), your sync history and CDC state are preserved. If you use Hightouch-managed storage with the standard sync engine, syncs will need a full resync after the migration and pre-migration debugger data may not carry over. ## Related resources * [Core concepts](https://docs.hightouch.com/workspace-management/overview.md) * [Governance best practices](https://docs.hightouch.com/workspace-management/governance.md) * [Environments](https://docs.hightouch.com/workspace-management/environments.md) * [Regions](https://docs.hightouch.com/security/regions.md) * [Storage](https://docs.hightouch.com/security/storage.md) * [Managing users and groups](https://docs.hightouch.com/workspace-management/user-management.md)