Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.messagedesk.com/llms.txt

Use this file to discover all available pages before exploring further.

Tenant Management

A tenant is the parent company account that owns one or more MessageDesk workspaces. Tenant admins can update tenant-level company details and spin up new workspaces for different teams, brands, or business units—all from a single account.
Tenant vs. Workspace: A tenant is your company. A workspace is an inbox under that company. Most users only need one workspace, but larger organizations can run multiple workspaces under the same tenant.

Who Can Manage a Tenant

Only users with the tenant admin role can:
  • Edit the tenant company profile.
  • Create new workspaces under the tenant.
Workspace-level admins (without tenant admin) can manage their own workspace but cannot edit tenant details or add new workspaces.

Update Tenant Company Details

  1. Click your profile icon (top-right) and open the workspace switcher.
  2. Select Manage tenant (visible to tenant admins only).
  3. Click Edit on the Tenant profile.
  4. Update your company name, address, website, or logo.
  5. Click Save.
Changes apply at the tenant level and are reflected across all workspaces under the tenant.

Create a New Workspace Under a Tenant

Tenant admins can create additional workspaces directly from the workspace selection screen—no need to sign up for a separate account.
  1. From the workspace switcher or workspace selection screen, click Create workspace.
  2. Enter a workspace name (e.g., “Sales”, “Support”, “West Coast Team”).
  3. Click Create.
When the workspace is created:
  • You’re automatically added as the workspace admin.
  • A new membership is created linking your user to the workspace.
  • The workspace appears under your tenant in the workspace selection screen.
After creating a workspace, follow the standard onboarding steps to connect phone numbers, import contacts, and invite teammates.

Workspace Selection Screen

When you sign in, the workspace selection screen groups your memberships by tenant. If you belong to multiple tenants or multiple workspaces under the same tenant, you’ll see them organized accordingly:
  • Tenant header — company name and logo.
  • Workspaces list — every workspace under that tenant where you’re a member.
  • Create workspace — visible only if you’re a tenant admin for that tenant.
Click any workspace to enter it, or use the workspace switcher inside the app to move between workspaces without signing out.

Frequently Asked Questions

Can a single user belong to multiple tenants?
Yes. If you’ve been invited to workspaces across different companies, each tenant appears as its own group on the workspace selection screen.
Who becomes the tenant admin?
The user who originally created the MessageDesk account is the default tenant admin. Additional tenant admins can be assigned by an existing tenant admin.
Can I delete a workspace under a tenant?
Workspaces can’t be deleted from the UI. Contact support to request workspace deletion. Tenant deletion follows the same process.
Does creating a new workspace require a separate subscription?
Billing for additional workspaces under the same tenant depends on your plan. See Billing & Subscriptions or contact support for details.