list_recipients
Retrieve all alert recipients in LogicMonitor, including email, SMS, and webhook endpoints. Use to audit notification targets and get IDs for escalation chain configuration.
Instructions
List all alert recipients (individual notification targets) in LogicMonitor (LM) monitoring.
Returns: Array of recipients with: id, type (email/SMS/webhook), contact information, method (email address, phone number, webhook URL), name, status.
What are recipients: Individual notification endpoints used in escalation chains. Can be: email addresses, SMS/phone numbers, webhook URLs, or integration endpoints (Slack, PagerDuty, etc.).
When to use:
Find recipient IDs for escalation chain configuration
Audit who can receive alerts
Verify contact information is current
Review notification endpoints before updating escalation chains
Recipient types explained:
Email: Email address (e.g., oncall@company.com, john.doe@company.com)
SMS: Mobile phone number (e.g., +1-555-123-4567)
Voice: Phone number for voice calls
Arbitrary: Custom webhooks for external integrations
Common use cases:
"Who can receive critical production alerts?" → List recipients used in escalation chains
"Update on-call phone number" → Find recipient by name, update contact info
"Add new team member to alerts" → Create recipient, add to escalation chain
"Remove former employee" → Find and delete recipient
Recipients vs Recipient Groups:
Recipients: Individual targets (one email, one phone)
Recipient Groups: Collections of recipients (notify entire team at once)
Workflow: Use this tool to find available recipients, then use in "create_escalation_chain" or "update_escalation_chain" to set up notifications.
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" (details), "list_recipient_groups" (group management), "list_escalation_chains" (see who gets notified).
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. |