Creating clients
Each client organisation lives in a completely isolated tenant. This page covers creating, configuring, and managing client tenants as an MSP admin.
A tenant is a completely isolated data space for one client organisation. Every asset, user, category, location, and request belongs to exactly one tenant. A client user can never see data from another tenant, even through the API.
Creating a client
Log in as MSP Admin and navigate to Clients in the left sidebar, then click New Client.
| Field | Required | Description |
|---|---|---|
| Company name | Yes | The full name of the client organisation — e.g. Acme Corp. Shown on the white-label login page and throughout the portal. |
| Slug | Yes | A short URL-safe identifier. Auto-fills from the company name (spaces become hyphens, special characters removed). Becomes the subdomain: acme → acme.atechsolutions.org. Only lowercase letters, numbers, and hyphens. Cannot be changed without breaking existing login URLs. |
| Currency | No | Three-letter currency code (e.g. USD, CAD, GBP). Used to display asset purchase costs. Defaults to USD. |
| Accent colour | No | Hex colour code (e.g. #3b82f6). Shown as the background tint on the white-label login page and as the active nav colour in the client portal. Defaults to #d4f034. |
| Logo URL | No | A publicly accessible image URL (HTTPS). Shown on the white-label login page instead of the Tether logo. Recommended dimensions: 200×60px or similar landscape format. |
Changing a slug immediately changes the subdomain URL. Any bookmarks or invite links using the old subdomain stop working. Existing user accounts are unaffected — they just need to use the new URL. If you must change a slug, inform all client users of the new login URL before making the change.
What gets created automatically
When you create a client, Tether automatically seeds default categories and locations so the client can start adding assets immediately without any extra configuration:
Default categories
- Laptop
- Desktop
- Monitor
- Phone
- Server
- Network
- Peripheral
Categories can be renamed, deleted, or added to at any time from Assets → Categories within the client portal.
Default locations
- Head Office
- Warehouse
- Remote
Locations can be managed from Assets → Locations.
Accessing a client tenant
As MSP staff, you have two ways to access a client's environment:
- Click "Open" on the Clients page — opens the client's subdomain in a new browser tab
- Navigate directly — go to
https://acme.atechsolutions.orgin your browser
When you access a client subdomain while logged in as MSP staff, all API calls are automatically scoped to that tenant. The sidebar shows the client name and all data (assets, people, requests) belongs to that client.
The MSP admin badge in the top-right of the sidebar indicates you are viewing a client as MSP staff. Client users never see this badge.
As MSP staff, your single login token works across all client subdomains. Navigate to acme.atechsolutions.org and you are automatically authenticated as MSP staff scoped to Acme.
Editing a client
On the Clients page, click the pencil icon next to any client. You can update:
- Company name (does not affect the subdomain)
- Slug (changes the subdomain — warn users first)
- Currency
- Accent colour
- Logo URL
- Active status (deactivating prevents all users from logging in)
Deleting a client
Click the trash icon next to a client and confirm the deletion.
Deleting a tenant permanently destroys all of its data: assets, users, categories, locations, people, checkout history, asset requests, and invite tokens. There is no recycle bin and no way to recover this data. Take a database backup before deleting any client.
Deactivating vs deleting
If a client relationship ends but you want to retain historical records, deactivate the client rather than deleting it. Go to Edit Client and uncheck Active. Deactivated tenants:
- Prevent all client users from logging in (they see an "account inactive" message)
- Remain visible in the MSP Clients list (greyed out)
- Retain all data — assets, history, users — unchanged
- Can be reactivated at any time by checking Active again
Custom domains
Clients can use a fully custom domain (e.g. assets.acme.com) instead of the default subdomain. See White-labelling for setup instructions.