← Back to home

Help Guide

A step-by-step walkthrough for getting your first client onboarded through ClientOnboard. Suitable for accounting firms, field service companies, consultancies, and any team with a repeatable client intake process.

1

Register your firm

Visit the Register page and complete the registration form:

  • Organisation Name — your practice or business name (e.g. Smith & Associates, ABC Field Services)
  • Subdomain — a short slug for your URL (e.g. smithassoc gives you smithassoc.clientonboard.co.za)
  • Email — your billing / admin email address
  • Plan — Starter, Pro, or Enterprise
First month free. No invoice is raised for the month you register in. Your first subscription invoice arrives on the 1st of the following month.
2

Configure platform settings (Super Admin)

The Super Admin controls platform-wide settings. Before you receive invoices, the super admin should configure:

  • Company name, address, phone, VAT registration number
  • Banking details (for invoice letterhead)
  • Invoice prefix (e.g. LK-2026-0001)
  • VAT rate (default 15% — adjustable if the SARS rate changes)
  • Invoice notes (e.g. overdue interest clause)

These settings are managed at Super Admin → Settings.

3

Add your team members

Your organisation uses three roles:

Admin

Manages the organisation, adds clients, configures settings, views all onboardings.

Accountant

Leads onboardings and oversees tasks. Receives notifications for all client activity. Rename to “Manager” or “Coordinator” in your head if it fits better.

Staff

Completes assigned tasks. Only sees tasks assigned to them.

Users can be added from your dashboard once logged in. Each user gets a unique email login.

4

Add a client

Navigate to Clients → Add Client and fill in:

  • Client name, company registration number, VAT number (where applicable)
  • Contact details (phone, email, physical address)
  • Engagement type — describe the service being rendered (e.g. Monthly Retainer, Project, Annual Review)
  • System or platform used (e.g. Xero, Pastel, Sage, your own field management system)
  • Allocated team lead — this person receives notifications for all activity on this client
  • Group (optional) — for organising clients by sector, region, or team
5

Start an onboarding

On the client detail page, click “Start Onboarding”. The system will:

  • Clone all 30+ task templates into a new onboarding checklist for this client
  • Assign each task to the correct role (Admin / Accountant / Staff)
  • Set the onboarding status to In Progress
  • Notify the allocated accountant that the onboarding has started

You can specify who prepared the onboarding (the responsible accountant) and the start date.

6

Work through tasks

Open the onboarding checklist. Tasks are grouped by phase. Each task shows:

  • The task description
  • Who it is assigned to (role)
  • Current status: Pending / In Progress / Complete / Rejected

To complete a task, click the checkbox or “Mark Complete” button. If the task has an input field (e.g. “Enter VAT number”), fill it in before completing.

Your dashboard shows all tasks assigned to your role across all active onboardings — so you always know what needs your attention today.
7

Comments and input fields

Some tasks have an input field (e.g. for a registration number, reference, date, or any custom value your process requires). Enter the value when completing the task — it is stored on the checklist and appears in the audit trail.

Any team member can add a comment to any task. Comments are visible on the task and in the history timeline. The assigned user and the allocated team lead both receive a notification when a comment is added.

8

Rejecting a task

If a task was completed incorrectly, use the Reject button. The rejection modal lets you:

  • Select a rejection reason from the dropdown (e.g. “Incorrect information”, “Document missing”)
  • Add free-text notes explaining the issue
  • Optionally return to a prior task (e.g. if supporting documents need re-collection before this task can proceed)

The rejected task reverts to Pending. The assigned user receives a notification. All rejections are recorded in the audit trail with the reason and actor.

9

Notifications

ClientOnboard sends in-app notifications (visible in your notification bell) for:

  • Task completed
  • Task rejected or returned to a prior step
  • New comment added
  • Input field updated
  • Onboarding started
  • Key phases completed (e.g. Quote sent, Agreement signed, Compliance complete)
  • Onboarding completed in full

Click any notification to go directly to the relevant task or onboarding.

10

Viewing history

Every onboarding has a History view (click “View History” on the onboarding page). This is a chronological audit trail of every event — completions, comments, rejections, input changes — with the actor and timestamp.

Use the history view to answer: “Who did what and when?” when reviewing a client file, during a handover, or in a quality check.

11

Subscription & billing

Your monthly subscription invoice is raised automatically on the 1st of each month. To view and pay your invoices:

  • Go to Subscription in your tenant portal (at yoursubdomain.clientonboard.co.za/subscription)
  • View all invoices: draft, sent, paid, and cancelled
  • Click “Pay Now” on any outstanding invoice to be redirected to PayFast for secure payment
  • Once PayFast confirms payment, the invoice is automatically marked as paid

All invoice amounts include VAT at the applicable rate. The invoice shows both the ex-VAT subtotal and VAT amount separately.

Note: The invoice PDF can be downloaded from each invoice’s detail page in the Super Admin portal. Tenant-facing download will be added in a future update.

Still need help?

Send us a message and we will get back to you within one business day.

Contact Us