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 35 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, Sales, Marketing, Finance, Administration) 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.

Inviting Several People at Once#

Paste or enter multiple email addresses to invite a group in one pass, with the same role and the same sub-account access applied to all of them. Each person still gets their own invitation.

If an invitation email cannot be delivered, the invitation says so rather than appearing to have been sent. That matters because the invite itself is still valid: you can pass the person their link another way instead of waiting on an email that is never going to arrive.

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.

You only ever see invitations for sub-accounts you have access to.

Finding People in Long Lists#

Anywhere you pick a team member, assigning a conversation, @mentioning someone in a note, choosing an owner, the picker is searchable. Type part of a name to filter. On a large team this is the difference between a usable list and one that quietly stops short of everyone.

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#