ClientSphereDocs
CRM

Accounts and contacts

Accounts are the companies you work with and contacts are the people. How to create them, link them, and keep one record per company.

An account is a client company. A contact is a person. Everything else in ClientSphere, from a ticket to an invoice, points at one or both, which is why the whole history of a relationship shows up in one place.

Before you start: roles with Read accounts and Read contacts to see them, the matching Create and Update permissions to change them.

Accounts

CRM → Accounts → Add Account. Only the Account Name is required. The rest is worth filling in because filters and reports use it: industry, company size, status, and tags.

Two ownership fields sit under Ownership & Support, and they are different people:

  • Account Owner is the salesperson responsible for the relationship.
  • Support Owner is the agent who handles its tickets. Support channels set to Account-Based assignment route new tickets to this person.

Both appear as columns and filters on the accounts list. Leaving either empty shows Unassigned.

The Add New Account dialog with the Ownership & Support section

Select and update several at once

On the accounts list, in either the table or the card view, each row or card has a checkbox. The box in the table header, or Select all on this page above the cards, selects every account on the current page only; it never reaches accounts on other pages, and the selection clears when you change the search, a filter, the page, or the page size, or switch sandbox mode. Ticking a box does not open the account; clicking elsewhere on the row still does. If your role has neither Update accounts nor Delete accounts, the checkboxes do not appear at all.

Once something is selected, a bar floats at the bottom of the screen showing how many are selected, with these actions. It stays put as you scroll, and the list leaves room beneath it so the last rows and the page controls stay reachable:

  • Change status: pick one of your account statuses. A confirmation says this may trigger automations that run when an account changes status.
  • Assign owner and Assign support owner: pick a teammate, or Unassigned. A confirmation names who the accounts will go to, for example "Assign 37 accounts to Jane?".
  • Add tags: type one or more tags separated by commas. They are added to each account's existing tags, never replacing them.
  • Delete: asks you to confirm first. Only roles with Delete accounts see it.

The other actions need Update accounts, including owner changes; you do not need the assign permission for these. When it finishes, a message reads "Updated 37", or "Updated 34 · 3 skipped" with the reason, for example an account that was deleted by someone else in the meantime. Up to 500 accounts can be changed in one go.

The account profile

Tabs across the top: Overview, Contacts, Opportunities, Tickets, Notes, Tasks, and Emails, each with a count. The Overview shows pipeline value, won revenue, open tickets, and the account's product activity if the floating launcher is installed on your product.

Tags are edited inline on the profile: type in Add tag… and press Enter or a comma. Tags are lower-cased and deduplicated, and they are what dynamic contact lists and automation triggers filter on.

Notes is for the team's own record. Type @ to mention a colleague.

Contacts

CRM → Contacts → Add Contact. First name, last name, and email are required. Pick an Account by typing to search; when one is chosen, an Account Relationship section appears with a status and a Primary contact checkbox.

The Contact filter on the contacts list is by industry, despite the label; Title and Location are fixed lists.

One person, several companies

A contact can belong to more than one account. On the contact's profile, Account Relationships lists them, with a Primary badge on the main one and a role such as "Decision Maker". Link Account adds another. The same relationship is visible from the account's Contacts tab, where Link Contact can either pick an existing person or create a new one in place.

Rows marked Legacy with a Migrate button are contacts linked the old way, before relationships existed. Migrating them is one click and loses nothing.

Last seen in product

The contact profile shows Last seen in product and days active out of the last 30 when the floating launcher is installed on your product with the user's identity. Otherwise it reads "Not seen yet". See Put the floating launcher on your product.

Keep it to one record per company

Accounts are matched by name and contacts by email when they are created through imports, the API, or the website embeds, so duplicates mostly come from hand entry and from converting leads for companies that already exist. Search before you create, and before you convert a lead.

If you add a contact by hand with an email that already belongs to someone, the form says who and offers to open that contact. On an account page, it offers to link the existing contact to the account instead, keeping the role and status you typed.

Merge duplicates

Select two to ten accounts with the checkboxes and choose Merge in the bar at the bottom. The button shows only for roles that have both Update accounts and Delete accounts (Owner, Admin and Manager) and is greyed out until two to ten are selected.

The dialog shows one column per account. Choose the one to Keep in the column header; it starts as the first one you selected. Each field then has a choice per column, and the kept account's value is picked unless you choose another. Fields where every record already agrees are greyed out. Tags are always combined from all records.

The note under the table lists what moves, for example "3 contacts, 2 opportunities, 5 notes move to Acme", and the merge button stays disabled while a warning is showing. Everything linked to the other records moves to the one you kept, and the others are removed. They can no longer be opened, and there is no undo in the app. The audit trail shows one Merged entry and a Deleted entry for each removed account. If someone else is changing one of the records, you are told to try again in a moment.

If a removed account had an External ID, it is discarded unless you picked it for the kept account, and imports or API calls using it no longer match anything.

Deleting

Deleting an account removes it from your lists, and it can no longer be opened. Its contacts, opportunities, and tickets are not deleted, but they no longer show under that account. Deleting a contact removes the person and their relationships. The app has no undo for either. For a company that has simply stopped being a customer, change its status instead; the history stays useful.

When it goes wrong

  • A contact's tickets or emails are not showing on the account. The contact is not linked to the account, or is linked as legacy. Link or migrate from the account's Contacts tab.
  • Tickets are being assigned to the wrong person. The account's Support Owner is out of date, and the channel uses Account-Based assignment.
  • "Website must be a valid URL starting with http:// or https://". Add the scheme.
  • Two accounts for one company. Move the contacts, opportunities, and tickets to the one you keep, then delete the other. There is no merge yet.

On this page