Sub-Account Setup Guide

Sub-accounts are client workspaces in Seedly CRM. Each sub-account is isolated - it has its own contacts, conversations, pipelines, workflows, invoices, and settings. Data from one sub-account is never visible from another.

This page covers creating sub-accounts, managing users and roles, and switching between accounts.

How Sub-Accounts Are Organized

Seedly CRM uses a three-tier hierarchy:

Agency
  └── Brand
        └── Sub-Account (one per client)

• Agency - The top-level entity. Your agency owns the entire installation and has visibility across all data.
• Brand - An organizational grouping within the agency. Brands can have their own branding, billing schedules, and integration credential overrides. If you only operate under one brand, a default brand is created automatically.
• Sub-Account - The working unit. Each sub-account represents one client and contains all of that client's data. Sub-accounts are strictly isolated from each other.

Sub-Account Types

There are two types of sub-accounts:

Admin Sub-Account

Every brand has one admin sub-account, created automatically when the brand is set up. The admin sub-account:

• Cannot be deactivated or cancelled - it is always available
• Works identically to a standard sub-account - it has its own contacts, pipelines, workflows, conversations, and all other features
• Controls credential cascade - it determines which integration credentials (SMS providers, email providers) are available to standard sub-accounts within the brand

The admin sub-account is your brand's own operational workspace. Use it for your agency's internal work or as a sandbox for testing workflows before deploying them to client accounts.

Standard Sub-Account

Standard sub-accounts are created for each of your clients. They operate independently - each account manages its own settings, phone numbers, email domains, and integrations. Brand settings do not automatically cascade to standard sub-accounts.

Creating a Sub-Account

1. Navigate to Settings → Sub-Accounts
2. Click Create Sub-Account
3. Enter a Name for the sub-account (required) - this is the display name your team will see
4. Optionally enter a Slug - a URL-friendly identifier. If left blank, one is generated automatically from the name
5. Click Create

The new sub-account is assigned to your currently active brand.

Things to Know

• The slug cannot be changed after creation - choose carefully if entering a custom one
• Only the name can be edited later
• You need the Sub-Accounts → Create permission to create new accounts

Sub-Account Lifecycle

Sub-accounts move through these states:

Managing Lifecycle

• Deactivate: Click the Deactivate button on a sub-account card. A confirmation dialog explains what will happen. Data is never deleted - deactivation only blocks access.
• Suspend / Resume: Suspending pauses all access temporarily. Resuming returns the account to active. Useful for billing holds or compliance situations.
• Cancel: Permanent closure. Confirm carefully before proceeding.

Admin sub-accounts cannot be deactivated, suspended, or cancelled.

User Roles

Seedly CRM includes four built-in system roles, arranged in a strict hierarchy:

Custom Roles

You can create custom roles at the agency level or sub-account level. Each custom role defines exactly what a team member can and cannot do, across 30+ modules with four actions each (view, create, update, delete).

To speed up role creation, start from a template:

Creating a Custom Role

1. Navigate to Settings → Access
2. In the Roles section, click New Role
3. Enter a Name and optional Description
4. Choose a Level - Agency or Sub-Account
5. Select a Template to start from, or configure permissions manually
6. Use the tab navigation (CRM, Communications, Advanced) to review permissions by category
7. Toggle individual permissions as needed - each module has checkboxes for View, Create, Update, and Delete
8. Click Save

Scope Control

For each permission, you can also set a scope that controls which records the user can access:

For example, a sales rep might be able to view all contacts but only edit the ones assigned to them.

Privilege Escalation Prevention

Users cannot create or assign a role that is equal to or higher than their own. This is enforced at the backend and cannot be bypassed.

Inviting Users

Sending an Invitation

1. Navigate to Settings → Access
2. In the Users section, click Invite User
3. Enter the user's Email Address
4. Select a Role from the dropdown
5. If you are an agency-level user, choose which Sub-Accounts the user should have access to. Sub-account admins inviting within their own account skip this step - the user is automatically assigned to the current sub-account
6. Click Send Invitation

What Happens Next

• New user: An invitation email is sent. The invitee has 7 days to sign up. When they create their account, they are automatically added to the sub-account with the assigned role.
• Existing user: If the email matches someone who already has an account, they are added immediately - no invitation email or waiting period.

Managing Invitations

Pending invitations appear below the users table. For each invitation you can see the email, who sent it, the assigned role, and whether it has expired. Click Revoke to cancel a pending invitation.

Copy Permissions

To quickly match one user's access to another:

1. Click Copy Permissions above the users table
2. Select the source user (copy from)
3. Select the target user (apply to)
4. Click Copy Permissions

This clones the source user's role assignment to the target user.

Teams

Teams let you group users for scope-based access control. When a permission scope is set to "Team", users can access records assigned to anyone on their team.

Creating a Team

1. Navigate to Settings → Access
2. In the Teams section, click New Team
3. Enter a Name and optional Description
4. Search and select Members from your active users
5. Click Save

A user can belong to multiple teams. Team membership affects which records they can see and edit when their role uses "Team" scope.

Switching Between Sub-Accounts

If you have access to multiple sub-accounts, use the account switcher in the sidebar to navigate between them.

How to Switch

1. Click the account name in the sidebar (near the top)
2. A popover opens showing all sub-accounts you have access to
3. Search by name using the search bar at the top
4. Click a sub-account to switch to it

The switch is instant - all modules (contacts, pipelines, conversations, and everything else) immediately reflect the selected account's data. No page reload is needed.

Identifying Accounts

• Admin sub-accounts are marked with a shield icon and grouped at the top
• Pinned accounts appear next - click the pin icon on any account to add it to your favorites
• Standard accounts are listed below

Pin your most-used accounts so they are always easy to reach.

Summary