Client management
Groups, entities, contacts, obligations, and client boarding — how your client data is structured in OneHQ.
Client structure overview
Clients in OneHQ are organised into Client Groups, each containing one or more Entities. A group represents a client relationship — for example, "Henderson Family" or "Williams & Co" — and entities are the individual tax structures within that relationship (companies, trusts, individuals, SMSFs, partnerships).
This two-level structure reflects how Australian accounting practices actually manage their clients. A single family or business group typically has multiple entities: a trading company, a family trust, individual tax returns for each director, and perhaps a self-managed super fund.
When you select a client group in OneHQ, you see all its entities listed together with their obligations, jobs, billing, and communication history. Entity-level views drill into the detail for a specific structure, while group-level views give you the full picture across all related entities.
Entity types
Each entity in OneHQ has a type that determines which fields and compliance obligations are available. The five entity types mirror the structures used by the ATO and ASIC:
| Entity type | Key fields | Typical obligations |
|---|---|---|
| Company | ABN, ACN, directors, shareholders, registered address | BAS, Tax Return, PAYG, STP, ASIC Annual Review, Payroll Tax |
| Trust | ABN, trustee, beneficiaries, trust type | BAS, Tax Return, PAYG, STP |
| Individual (ITR) | Name, TFN, date of birth, spouse link | Tax Return |
| SMSF | ABN, members, trustees, auditor | SMSF Annual Return, BAS |
| Partnership | ABN, partners | BAS, Tax Return, PAYG |
All entity types support registrations (GST, PAYG withholding, PAYG instalments, FBT, etc.), contacts, and obligations. The type primarily affects which people fields are shown (directors vs. beneficiaries vs. members) and which obligations are relevant.
Adding clients
There are two ways to add clients to OneHQ:
Add a new client group
Click the "+" button in the Client mode sidebar or use the Add Client action. This creates a new client group and its first entity at the same time. You provide:
- Group name — the client relationship name (e.g. "Henderson Family")
- Entity name — the first entity's legal name
- Entity type — Company, Trust, Individual, SMSF, or Partnership
- ABN — optional but recommended for Xero auto-matching
- Accountant & Bookkeeper — assign staff members responsible for this client
Add an entity to an existing group
Open a client group, then click "Add Entity" to add another entity to that group. This is how you build out a client's full structure — adding the family trust, individual returns, SMSF, and so on under the same group.
Contacts
Each entity has a list of contacts — the people associated with that entity. Depending on the entity type, these might be directors, trustees, beneficiaries, individual taxpayers, SMSF members, or partners.
Each contact record includes:
- Name — full name of the person
- Email — used for e-signing requests and email communications
- Phone — used for SMS and phone call logging
- Role — their role in relation to the entity (director, trustee, beneficiary, etc.)
Cross-entity linking
Contacts can be linked across entities within the same group. For example, John Henderson might be a director of Henderson Trading Pty Ltd and also a trustee of the Henderson Family Trust. Rather than duplicating contact details, you link the same person across both entities.
Linked contacts share the same email and phone details, so updating one updates all linked instances. This is particularly useful for e-signing — when a document is sent for signature, OneHQ looks up the signer's email from the entity's contacts.
Obligations
Obligations are the compliance requirements assigned to each entity. They define what work needs to be done and how often. When obligations are set on an entity, OneHQ uses them to generate jobs automatically.
Obligation types
| Obligation | Frequency | Description |
|---|---|---|
| BAS | Monthly / Quarterly | Business Activity Statement — GST, PAYG withholding, PAYG instalments |
| Tax Return | Annual | Income tax return for companies, trusts, individuals, partnerships |
| PAYG | Quarterly | PAYG instalment reporting |
| STP Finalisation | Annual | Single Touch Payroll year-end finalisation |
| Payroll Tax | Monthly / Annual | State-based payroll tax returns |
| WorkCover | Annual | Workers compensation insurance renewal |
| FBT | Annual | Fringe Benefits Tax return |
| SMSF Annual Return | Annual | Self-managed super fund annual return and audit |
| ASIC Annual Review | Annual | Annual company review statement |
Assigning obligations
Obligations are set per entity via the entity's Compliance tab or when editing an entity. Each obligation can have a preparer assigned — the staff member responsible for completing that work. Obligations also support state selection for state-based requirements like Payroll Tax.
Practice-wide configuration
Obligation types are configured at the practice level in Settings > Setup & Menus. You can customise which obligation types are available, their frequencies, and add custom obligation types specific to your practice. System obligation types (BAS, Tax Return, etc.) cannot be deleted but can be customised.
Client boarding
OneHQ includes built-in onboarding and offboarding workflows to manage the process of taking on new clients or transitioning clients out of your practice.
How boarding works
Create a boarding entry
From the Billing section, go to the Onboarding or Offboarding tab and add a client. Set target completion days, fee amount, and the reason for boarding.
Work through the checklist
Each boarding entry has a checklist of tasks to complete. Tick items off as you go — progress is tracked and visible to the whole team.
Track progress
The boarding panel shows completion percentage, days remaining against the target, and which checklist items are outstanding. Overdue boarding entries appear as alerts on the Practice Dashboard.
Customising checklists
Boarding checklists are customisable per practice. Go to Settings > Setup & Menus to add, edit, reorder, or remove checklist items. Default items are seeded when you create your practice, but you can tailor them to match your firm's processes. Separate checklists are maintained for onboarding and offboarding.
Communication history
Every entity and client group in OneHQ maintains a communication timeline — a chronological record of all interactions with that client. This creates a complete audit trail that any team member can review.
Communication types
The timeline supports several entry types:
- Email — logged email correspondence (synced from Gmail/Outlook or manually added)
- Phone call — notes from phone conversations with clients
- Note — internal notes, file notes, or memos about the client
- Lodgement — records of returns or documents lodged with the ATO or other bodies
- Payment — payment receipts or fee payment records
- SMS sent / SMS received — text message conversations via ClickSend
Group vs. entity communications
Communications can be logged at either the group level (visible when viewing the group) or the entity level (visible on the specific entity's Communication tab). Group-level communications are useful for matters that span multiple entities, while entity-level entries keep the history focused on a specific structure.
Frequently asked questions
Not currently. To move an entity to a different group, you would need to delete it from the current group and re-create it under the new group. We recommend getting your group structure right when adding clients, but we understand that client relationships can change over time.
Entities can be removed from groups individually. Deleting a client group removes all its entities along with their associated jobs, billing records, and communication history. Use the edit options on the entity or group to access delete actions.
Be careful — deletion is permanent. Consider using the offboarding workflow instead if you want to retain a record of the client relationship while marking them as no longer active.
A group is the client relationship — it represents the person, family, or business you work with. Think of it as the folder that holds everything related to that client.
An entity is an individual tax structure within that group — a specific company, trust, individual tax return, SMSF, or partnership. Each entity has its own ABN, obligations, contacts, and compliance jobs.
For example, the "Henderson Family" group might contain: Henderson Trading Pty Ltd (Company), Henderson Family Trust (Trust), John Henderson (Individual ITR), and Jane Henderson (Individual ITR).
Not yet. Clients are currently added individually through the Add Client modal. Bulk import is a commonly requested feature and is on the roadmap. In the meantime, the Add Client flow is designed to be quick — most clients can be added in under a minute.
Need more help with managing clients?
Get in touch