Tags
Tags let you label and categorize patients and calls. Use them to flag status, group records by criteria, or filter your patient list. For example, you might create tags like “VIP”, “Needs Follow-Up”, or “Spanish Speaking”.
Manage tags from Settings → Tags.
Quick Start
- Go to Settings → Tags in your Solum dashboard.
- Click “Add Tag” to open the creation dialog.
- Enter a name and choose a type (Patient or Call).
- Save — the tag is now available to apply to records.
- Apply it to patients from the patient profile, or include it in a batch import.
Tag Types
Tags are scoped by type — each tag applies to one kind of record.
| Type | Color | Used On |
|---|
| Patient | Blue | Patient records |
| Call | Amber | Call records |
When tagging a patient, only Patient-type tags appear. When tagging a call, only Call-type tags appear.
Creating a Tag
Click Add Tag to open the creation dialog. Fill in:
- Name (required) — The label shown on records (e.g., “Urgent”, “New Referral”).
- Type (required) — Patient or Call. Defaults to Patient.
Tag names must be unique per type within your company. You cannot have two Patient tags both named “VIP”, but you can have a Patient tag and a Call tag with the same name.
The tag type cannot be changed after creation. Choose carefully.
Editing a Tag
Click the edit action on any tag to rename it. The type cannot be changed after creation.
Deleting a Tag
Click the delete action on a tag to remove it.
Deleting a tag permanently removes it and detaches it from all associated records (patients or calls). This action cannot be undone.
From the Patient Profile
- Open a patient and click Edit.
- Expand the Additional Information section.
- Use the tag dropdown to search and select tags.
- Save the patient.
Selected tags appear as badges on the patient profile. Click the X on a badge to remove a tag.
Via the API
When creating or updating patients through the /v1/patients endpoint:
- Set all tags:
{ "tags": ["tag-id-1", "tag-id-2"] } — replaces the full tag list
- Add tags:
{ "add_tags": ["tag-id"] } — adds without removing existing tags
- Remove tags:
{ "remove_tags": ["tag-id"] } — removes specific tags
You can use tag UUIDs or tag names (matched case-insensitively). Maximum 50 tags per patient.
You cannot combine tags with add_tags or remove_tags in the same request. Use one approach or the other.
Via Batch Import
Include a tags column in your CSV when using Batch Patient Import. Use comma-separated tag names or IDs.
On the patient list page, use the tag filter to show only patients with specific tags. Two filter modes are available:
- Any (default) — shows patients that have at least one of the selected tags
- All — shows patients that have every selected tag
You can configure tags to be automatically applied to new patients or calls created through voice AI interactions.
- Go to Settings → Company.
- Find the Auto-assign Tags section.
- Check the tags you want automatically applied.
Auto-assigned tags are applied alongside any other tags set during record creation.
Troubleshooting
| Problem | Fix |
|---|
| Cannot change a tag’s type | Tag type is set at creation and cannot be changed. Create a new tag with the correct type instead. |
| ”Tag name already exists” | A tag with that name and type already exists in your company. Choose a different name. |
| Tag not showing in patient edit | Only Patient-type tags appear when editing patients. Check that the tag type is Patient in Settings → Tags. |
| Tag disappeared from patients | The tag was likely deleted. Deleting a tag removes it from all records. |
Cannot use tags and add_tags together | The API does not allow combining replace and incremental operations. Use tags to set the full list, or add_tags/remove_tags for incremental changes. |