list_recipient_groups
Retrieve all recipient groups to simplify team notifications and manage escalation chains. Find group IDs, members, and descriptions for audit or updates.
Instructions
List all recipient groups in LogicMonitor (LM) monitoring.
Returns: Array of recipient groups with: id, name, description, member count, recipients list.
What are recipient groups: Collections of recipients treated as a single notification target. Simplify escalation chains by notifying entire teams at once. Example: "Database Team" group contains 5 team members - notify group = notify all 5.
When to use:
Find group IDs for escalation chains
Audit team notification lists
Review group membership before changes
Simplify notification management
Benefits over individual recipients:
Easier management: Update team once, applies to all escalation chains using that group
Team notifications: Notify entire team simultaneously
Organized: Group by function (DB team, Network team, On-call rotation)
Common recipient groups:
"On-Call Engineers" - Current on-call rotation members
"Database Team" - All database administrators
"Network Operations" - NOC team members
"Management" - For escalation to leadership
Use cases:
"Notify entire team for critical alerts" → Use group instead of 5 individual recipients
"Rotate on-call" → Update group members without touching escalation chains
"Add new team member" → Add to group, automatically included in alerts
Workflow: Use this tool to find groups, then use in escalation chains to notify multiple people at once.
Important: A negative "total" value in the response indicates incomplete results. Use pagination (size/offset parameters) or set autoPaginate: true to retrieve all items.
Related tools: "get_recipient_group" (details), "list_recipients" (individual members), "list_escalation_chains" (see usage).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Number of results per page (default: 50, max: 1000). | |
| offset | No | Starting offset for pagination (default: 0). Use this to skip a specific number of results. | |
| autoPaginate | No | Automatically fetch all pages (default: false). When true, fetches all results across multiple pages. When false, returns only the requested page. Use false for large result sets to avoid long response times. | |
| filter | No | Filter expression using LogicMonitor query syntax. Examples: name:*prod*, displayName~*server*, id>100, hostStatus:normal. Available operators: : (equals), ~ (includes), !: (not equals), !~ (not includes), >: (greater than or equals), <: (less than or equals), > (greater than), < (less than). Multiple conditions: Use comma (,) for AND, use || for OR. Do NOT use &&. | |
| fields | No | Comma-separated list of fields to include in response. Examples: "id,displayName,hostStatus" or use "*" for all fields. Omit this parameter to receive a curated set of commonly used fields. |