If you already maintain a client list in your practice manager, accounting software, or a spreadsheet, you do not need to enter clients one by one. ClearAML’s bulk CSV import lets you bring your entire client base in at once, map your existing column headers to ClearAML’s fields, and optionally trigger PEP and sanctions screening on every imported client in a single operation.Documentation Index
Fetch the complete documentation index at: https://docs.clearaml.com.au/llms.txt
Use this file to discover all available pages before exploring further.
Step 1: Prepare your CSV file
Your CSV must include at least the columns required for each client type. Everything else is optional but improves the accuracy of the automatic risk assessment.Required fields
| Client type | Required columns |
|---|---|
| Individual | type, first_name, last_name |
| Company | type, company_name |
| Trust | type, company_name |
| Sole trader | type, company_name |
| Partnership | type, company_name |
type column must contain one of the following exact values: individual, company, trust, sole_trader, partnership, other_business.
Optional but recommended fields
Including these fields improves risk scoring accuracy and reduces the manual work required after import:| Column | Description |
|---|---|
email | Client email address |
phone | Client phone number |
date_of_birth | Individual’s date of birth (YYYY-MM-DD) |
address_line1 | Street address |
suburb | Suburb |
state | State (e.g. VIC, NSW) |
postcode | Postcode |
country | Two-letter country code (defaults to AU) |
abn | ABN for business entities |
acn | ACN for companies |
trading_name | Trading name (if different from legal name) |
business_activity | Nature of the client’s business |
date_established | Date the entity was established (YYYY-MM-DD) |
Step 2: Upload your CSV via the dashboard
Navigate to the Clients section
Log in to ClearAML and open the Clients tab from the left navigation menu.
Click 'Import Clients'
Select Import Clients from the top-right action menu. The import modal will open.
Upload your CSV file
Drag and drop your
.csv file onto the upload area, or click Browse to select it from your computer. The system accepts files up to 500 rows per import. If your list is larger, split it into multiple files.Map your column headers
ClearAML reads the column headers from your file and displays a field-mapping screen. For each column in your file, select the matching ClearAML field from the dropdown. Required fields are highlighted — you cannot proceed until all required fields are mapped.
Choose whether to include screening
Toggle Run PEP & Sanctions screening on or off before confirming the import. If enabled, ClearAML will screen every imported client against global watchlists as part of the import process. This uses your screening credits.
Step 3: Review your imported clients
After the import completes, you will see a results summary showing:- Successful — number of clients created
- Failed — number of rows that could not be imported, with an error message for each
- Screened — number of clients where PEP & sanctions screening ran (if enabled)
After a successful import, each client appears in your Clients list with an initial risk score already calculated. Clients who require identity verification will show a Verification pending status. You can bulk-send verification links from the Clients list view, or open each profile individually to review and act on the risk assessment.
Step 4: Start risk assessments
Once clients are imported, you can begin the KYC and risk assessment workflow:- Filter by status — use the status filter to find all clients with
Verification pending - Bulk-send verification links — select multiple clients and click Send Verification Link to notify them all at once
- Monitor progress — the dashboard shows how many clients have completed verification, are awaiting action, or have flagged PEP/sanctions results requiring review
Import limits and error handling
| Limit | Value |
|---|---|
| Maximum rows per import | 500 |
| Accepted file format | CSV (UTF-8) |
| Date format | YYYY-MM-DD |
| Country codes | ISO 3166-1 alpha-2 (e.g. AU, NZ, GB) |