Help
Help Managing clients Adding clients

Adding clients

There are two ways to get clients into TaxBloc: add them one at a time as you create consent requests, or bulk-upload a list via CSV. Both flows pull live data from Companies House so you don't have to type out registered addresses or year-ends.

Add a single client

Adding one client is the same flow as creating their first consent request — there's no separate "add client" step. The client record is created the moment you click Send request.

  1. Click + Create request in the top-right corner of any page.
  2. Enter the client's email. This becomes the canonical contact for that client.
  3. Pick the export type — the entity classification (see entity types).
  4. Search Companies House by name or 8-digit number. Picking a result auto-fills the registered office, year-end and filing status.
  5. Send the request. The client now appears under Clients with status Awaiting consent.
Create request with Companies House lookup
Searching Companies House by name or company number. Results show registered name, status and number.

Bulk import via CSV

If you're moving an existing client book into TaxBloc, the CSV import is the fastest path. You can upload up to 100 clients at once.

CSV format

Only two columns are required: company_number and client_email. Everything else (registered name, address, year-end, filing status) is auto-fetched from Companies House and validated before import.

Tip: Download a pre-formatted template from the import dialog — it's faster than building a CSV from scratch, and it shows the column headers TaxBloc expects.

Step by step

  1. Go to Clients in the left sidebar, then click Import CSV in the top-right.
  2. Drop your CSV into the upload zone (or click to browse). Maximum 5 MB, 100 rows.
  3. Review the validation table. TaxBloc cross-checks every company_number against Companies House. Rows with bad numbers, dissolved companies, or missing emails are flagged before you commit.
  4. Confirm import. Clients are added to your workspace, but no consent invitations are sent yet — that's a separate step (see Creating a consent request).
CSV import drop zone
The import dialog. Drag a CSV in, or click to browse.
CSV import validation table
Pre-import validation. Each row is checked against Companies House before any data lands in your workspace.

Entity types you can add

TaxBloc supports the full range of UK business entities. The Companies House lookup is available for the four registered types:

For unincorporated clients, you'll skip the Companies House step:

Common questions

Can I edit a client's details after import? Yes. Open the client from the Clients page and edit fields inline. Companies House data refreshes automatically every 24 hours.

What if a company number is invalid? The row is flagged in the validation step with a red Not found badge. You can fix it in the CSV and re-upload, or skip that row.

Does the import send invitations? No — bulk import only adds clients to your workspace. To send consent requests, go to Creating a consent request or use the bulk-send action on the Clients page.

Related