Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.msportal.ai/llms.txt

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

Portals are active onboarding instances launched for a specific company. When you create a portal from a template, it copies the template’s phases and tasks into a live workspace where you track progress, communicate with clients, and manage the onboarding process.

​
Launching a Portal

1

Open the Company Page

Navigate to the company you want to onboard and click the Onboarding tab.
2

Start Onboarding

Click Start Onboarding. Select a template from the dropdown — this determines the phases, tasks, and structure of the portal.
3

Add Client Contacts

Add the client contacts who will access the portal. Enter their name, email, and role. Mark one contact as Primary.
4

Activate the Portal

Click Start Portal to activate it. This generates secure access links for each contact and optionally sends invite emails.
You can also create a portal in Draft mode first, make adjustments to tasks and phases, and activate it later when ready.

​
Portal Lifecycle

Portals move through these stages:
StatusDescription
DraftBeing configured, not yet visible to clients
ActiveLive — clients can access and complete tasks
CompletedAll phases and tasks finished
ConvertedMigrated to your permanent systems (optional final step)
ArchivedHistorical record, no longer active

​
The Onboarding Tab

The company onboarding page has four tabs for managing the portal:

​
Overview Tab

The main dashboard showing:
  • Portal status with progress percentage
  • Phase-by-phase progress bars showing completion
  • Task summary with counts by status
  • Quick actions for managing the portal lifecycle

​
Tasks Tab

The primary workspace for managing onboarding tasks.

​
Status Legend

At the top, a legend shows the four task statuses with their icons:
  • Pending (circle) — Not yet started
  • In Progress (clock) — Work underway
  • Completed (checkmark) — Done
  • Blocked (lock) — Waiting on a dependency
Click a task’s status icon to cycle it forward (pending → in progress → completed). Right-click to choose any status from a dropdown menu.

​
Phase Accordions

Tasks are grouped by phase in expandable accordions. Each phase header shows:
  • Phase name and status badge
  • Task completion count (e.g., “3 of 7 completed”)
  • Progress bar
Click a phase to expand it and see all tasks within.

​
Task Rows

Each task row displays:
  • Status icon — Click to update, right-click for all options
  • Task title — With evidence type badge (signature, credentials, meeting, etc.)
  • Owner badge — MSP or Client
  • Due date — Red if overdue, amber if due within 3 days
  • Assigned user — Who is responsible
  • Priority indicator — For high and critical tasks
Click a task row to expand its detail panel, which shows:
  • Evidence content (signatures, credentials, uploaded files, survey responses)
  • Task description
  • Comment thread for discussion
  • Checklist items (if attached)

​
Task Assignment

Assign tasks to MSP team members individually:
1

Click the Assignee Area

Click the assignee name or “Unassigned” on any task row.
2

Select a User

Search and select a team member from the dropdown.
For bulk reassignment, click Reassign in the toolbar to enter selection mode. Use checkboxes (with shift-click for range selection) to select multiple tasks, then assign them all at once.

​
Sending Task Emails

Send task summary emails to client contacts:
  • Send All Tasks — Emails a complete summary of all tasks with status and due dates
  • Send Phase Tasks — Emails tasks for a specific phase only
  • Send Task Reminder — Send a reminder for an individual task
Each email includes task descriptions, status badges, due dates, and a link back to the portal.

​
Documents Tab

The document triage inbox where you review files uploaded by clients.
  • Filter by status — View all, pending review, approved, or rejected documents
  • Search — Find documents by name or phase
  • Review actions — Click a document to approve or reject it with optional notes
  • Download — Download the original uploaded file

​
Activity Tab

A complete audit trail of every portal event, with server-side search and type filtering. Events tracked include:
  • Portal and phase status changes
  • Task completions and assignments
  • Document uploads, approvals, and rejections
  • Contact access and invitations
  • Signatures and credential submissions
  • Meeting scheduling
  • Comments and questions
Use the search bar to find events by description, actor name, or email. Use the type filter dropdown to show only specific event categories (Portal, Phase, Task, Document, Contact, etc.).

​
Contact Management

Manage who has access to the client portal.

​
Adding Contacts

1

Open the Contact List

In the portal overview, find the contacts section.
2

Add a Contact

Click Add Contact and enter the contact’s name, email, and role.
3

Send Invite

Click Send Invite to email the contact their secure access link.

​
Contact Roles

Assign roles to help identify each contact’s responsibility:
  • Primary Contact
  • IT Contact
  • Decision Maker
  • Finance Contact
  • Office Manager

​
Managing Access

  • Resend Invite — Send the access link again if the contact lost it
  • Revoke Access — Immediately disable a contact’s portal access
  • Regenerate Token — Create a new access link (invalidates the old one)
Contact activity is tracked — you can see when each contact last accessed the portal and how many times.

​
Meeting Scheduling

Schedule meetings directly from meeting-type tasks.
1

Click Schedule Meeting

On a meeting task, click Schedule Meeting.
2

Set Meeting Details

Enter the date, time, duration, and optional description. Add a meeting link if using a specific platform.
3

Select Attendees

Choose from portal contacts and optionally add external attendees by email.
4

Send Invitations

Click Schedule to send calendar invitations (ICS) via email to all attendees.

​
Credential & Signature Review

​
Reviewing Credentials

When a client submits credentials through a credential handoff task:
  1. Open the task detail panel
  2. Click Reveal Credentials to view the submitted values
  3. Credentials auto-hide after 5 minutes for security
  4. For bulk submissions, download the uploaded file

​
Reviewing Signatures

When a client signs a signature task:
  1. Open the task detail panel to view the signature image
  2. See signer details: name, email, IP address, and timestamp
  3. If a document was attached, the signed document is also available

​
PSA Integration

Link onboarding portals to your PSA to track onboarding as a project, create tickets from tasks, and log time against onboarding work.

​
Linking a Portal to a PSA Project

1

Open the Portal Overview

Navigate to the company’s onboarding tab and open the active portal.
2

Click Link PSA Project

In the overview actions, click Link PSA Project.
3

Choose an Option

  • Link Existing: Search for and select an existing project in your PSA
  • Create New: Enter a project name and description to create a new project directly from MSPortal
Once linked, a PSA project badge appears on the portal overview showing the linked project name with a direct link to your PSA.

​
Creating PSA Tickets from Tasks

Convert onboarding tasks into PSA tickets to track them in your ticketing workflow.
1

Open Bulk Create

Click Create PSA Tickets in the portal actions. This opens a dialog listing all tasks.
2

Select Tasks

Check the tasks you want to create tickets for. Tasks that already have linked PSA tickets are shown but disabled.
3

Create Tickets

Click Create. MSPortal creates a ticket in your PSA for each selected task under the linked project. Each task gets a badge showing the PSA ticket number.
Click any task’s PSA ticket badge to open the ticket directly in your PSA.

​
Logging Time

Log time entries against onboarding tasks directly from the portal.
1

Click the Clock Icon

On any task with a linked PSA ticket, click the time entry icon.
2

Enter Time Details

Fill in duration, description, and whether the time is billable. Billable defaults are configurable in Settings > Onboarding.
3

Submit

The time entry is created in your PSA under the linked project and ticket.
PSA integration works with Halo PSA, ConnectWise Manage, Autotask, and Syncro. The portal must be linked to a PSA project before you can create tickets or log time.

​
Completing a Portal

When all tasks and phases are complete:
1

Review Completion

Verify all tasks show as completed and all documents are approved.
2

Complete the Portal

Click Complete Portal in the overview actions. This marks the portal as finished.
3

Convert (Optional)

If this client is now fully set up in your systems, click Convert to mark the portal as converted — a final status indicating the client has been migrated to your permanent tooling.

​
Managing Portals from Settings

The portal list in Settings > Onboarding > Portals provides a centralized view of all portals across companies. Each portal row has an actions menu (three dots) with the following options:
  • View Portal — Navigate to the company’s onboarding page for this portal
  • Archive — Deactivate the portal and revoke all client sessions. Portal data is preserved but clients can no longer access it. A confirmation dialog explains the impact before proceeding.
  • Restore — Return an archived portal to draft status so it can be reactivated. Only available for archived portals.
  • Delete — Permanently remove the portal and all associated phases, tasks, documents, and contacts. This action cannot be undone. A confirmation dialog requires explicit approval.
Archiving revokes all active client sessions immediately. Clients will lose access to the portal until it is restored and reactivated. Deleting is permanent and removes all portal data.

​
Dashboard Integration

Your MSP dashboard shows onboarding information in two places:
  • Active Onboarding Banner — Quick-link pills showing each active portal with company name, portal name, and a progress bar. Click to jump directly to the portal.
  • My Onboarding Tasks Widget — A card showing your personally assigned onboarding tasks across all active portals, ordered by phase and task order. Click any task to go to its portal.
Both are visible only when you have onboarding permissions and there are active portals.

​
Best Practices

Create portals in draft mode first. Review the tasks, adjust descriptions for the specific client, and add contacts before activating. This avoids sending premature invitations.
Assign MSP tasks to specific team members as soon as the portal goes active. This ensures tasks appear in everyone’s dashboard widget.
Check the activity feed regularly to stay informed about client progress. You can see exactly when contacts access the portal and complete tasks.
Don’t wait for clients to log in. Use the email features to send task summaries and reminders, especially for overdue items.
Clients see document status in their portal. Leaving documents in “pending review” for too long creates a poor experience — aim to review within 24 hours.