Client Groups

Last updated: November 17, 2026

Client groups let you put clients into named sets, such as "Healthcare", "Gold tier" or "Managed by Team East". You can then use a group anywhere you would pick a single client: in 📄 Scheduled Reports, 📄 Risk Insights, remediation schedules with 📄 Cork Reaper (Automated Software Vulnerability Remediation) FAQand📄 PSA Ticketing. You can also run actions on every client in a group in one step.

Creating a group

  1. Go to Clients and open the Groups tab.

  2. Click New group. Give the group a name and choose a label color.

  3. Add the clients you want in the group, then save.

A client can belong to more than one group. Each group shows as a colored label next to the client's name in the Clients table. You can also filter the table by group.

To change a group later, open the â‹® menu on its row and choose Edit to rename it, change its color, or add and remove clients.

Groups stay up to date

A group always means "the clients in it right now". When you add a client to a group, it is automatically included in everything that uses that group: scheduled reports, patch schedules, PSA ticket configurations and delegated access. When you remove a client, it drops out of all of them.

Hidden clients can stay in a group, but they are left out wherever the group is used.

Using a group as a scope

Wherever you choose which clients something applies to, the picker now lists groups alongside individual clients. You can use a group for:

  • Reports and scheduled reports: one report covering every client in the group

  • Risk Insights and compliance event filters

  • Software vulnerabilities

  • Patch schedules: one schedule per group. If a client has its own schedule, that schedule wins. Otherwise the group schedule applies, and if there is no group schedule, the partner-wide one does.

  • PSA ticket configurations: limit ticket creation to any mix of clients and groups

  • Corkboard statistics

Shortcuts from the group row

The â‹® menu on each group row has shortcuts that open a page already set to that group:

  • Create ›: Report, Scheduled report, Patch schedule, PSA ticket config

  • View ›: Risk Insights, Corkboard, Vulnerabilities for that group

Bulk actions

You can run these actions on a whole group, or on clients you select in the Clients table (using the Actions menu):

Menu

Action

Clients ›

Hide/Unhide clients, Send financial protection notice

Manage notifications ›

Compliance and vulnerability notification settings

How bulk actions work:

  • You always see a preview first. Before anything changes, Cork lists exactly which clients will be affected and which will be skipped, and why. Nothing happens until you confirm.

  • Actions run in the background. You can leave the page while one runs. The Clients page shows progress, and you get a notification when it finishes, with results for each client.

  • A group action applies once. It applies to the clients in the group at the time you run it. A client added to the group later is not affected, so run the action again if you need to.

  • Silencing adds to existing settings. Silencing compliance notifications only changes the event types you choose. Each client's other silenced notifications stay as they are.

  • Vulnerability silencing only offers software that is actually present on the clients you selected.

  • Financial protection notices are sent to each client's saved contact. Clients without a contact are flagged in the preview so you can add one first.

You can act on up to 1,000 clients and 50 groups at a time. You only see the actions your role has permission to run.

Delegated access through groups

You can give Delegated Access users access to a group instead of listing clients one by one. They see every client currently in the group, and that changes as the group changes.

To manage this, open the group's â‹® menu and choose Manage delegated access. You can also do it per user in Team settings. Both need permission to manage your team.

A Delegated Access user who has no clients or groups delegated can still sign in. They see a "You don't have access to any clients yet" screen.

Deleting a group

Choose Delete from the group's â‹® menu. Before you confirm, Cork lists everything that uses the group: scheduled reports, patch schedules, PSA ticket configurations and delegated access. All of those are removed along with the group. The clients themselves are not affected.

If the group is used by PSA ticketing or patch schedules, or has users delegated to it, you need the matching admin permissions to delete it. Without them, Cork asks you to contact an admin.

Public API

GET /api/v1/client-groups lists your groups. You can filter the client and software vulnerability endpoints by group_uuid. Groups are read-only in the API, so create and manage them in the Cork app.