Actions277
- User Agents Actions
- Url Filters Actions
- Users Actions
- Traffic Reports Actions
- Traffic Reports Qps Active Agents
- Traffic Reports Qps Active Users
- Traffic Reports Qps Active Collections
- Traffic Reports Top Domains
- Traffic Reports Top Categories
- Traffic Reports Top Application Categories
- Traffic Reports Top Organizations
- Traffic Reports Top Networks
- Traffic Reports Top Agents
- Traffic Reports Top Users
- Traffic Reports Top Collections
- Traffic Reports Query Logs
- Traffic Reports Total Organizations Stats
- Traffic Reports Total Domain Stats
- Traffic Reports Total Category Stats
- Traffic Reports Total Organizations Requests
- Traffic Reports Total Domain Requests
- Traffic Reports Top Organizations Requests
- Traffic Reports Total Client Stats
- Traffic Reports Total Deployments
- Traffic Reports Total Roaming Clients
- Traffic Reports Total Applications Stats
- Traffic Reports Total Applications Organizations Stats
- Traffic Reports Total Applications Networks Stats
- Traffic Reports Total Applications Agents Stats
- Traffic Reports Total Applications Users Stats
- Traffic Reports Total Applications Collections Stats
- Traffic Reports Total Requests
- Traffic Reports Total Requests Geo
- Traffic Reports Total Requests Organizations
- Traffic Reports Total Requests Agents
- Traffic Reports Total Requests Users
- Traffic Reports Total Requests Collections
- Traffic Reports Total Threats
- Traffic Reports Total Threats Organizations
- Traffic Reports Total Threats Agents
- Traffic Reports Total Threats Users
- Traffic Reports Total Threats Collections
- Traffic Reports Total Categories
- Traffic Reports Total Categories Organizations
- Traffic Reports Total Categories Agents
- Traffic Reports Total Categories Users
- Traffic Reports Total Categories Collections
- Traffic Reports Total Domains
- Traffic Reports Total Domains Organizations
- Traffic Reports Total Domains Users
- Traffic Reports Total Domains Collections
- Traffic Reports Total Collections
- Traffic Reports Total Collections Organizations
- Traffic Reports Total Collections Agents
- Traffic Reports Total Collections Users
- Traffic Reports Qps
- Traffic Reports Qps Active Organizations
- Trials Actions
- User Agent Bulk Deletes Actions
- User Agent Bulk Updates Actions
- User Agent Cleanups Actions
- User Agent Csv Exports Actions
- Policies Actions
- Policies Add Blacklist Category
- Policies Remove Blacklist Category
- Policies Add Allowed Application
- Policies Remove Allowed Application
- Policies Add Blocked Application
- Policies Remove Blocked Application
- Policies Get Permissive Mode
- Policies Index
- Policies Create
- Policies All
- Policies Show
- Policies Update
- Policies Destroy
- Policies Application
- Policies Application Update
- Policies Add Blacklist Domain
- Policies Remove Blacklist Domain
- Policies Add Whitelist Domain
- Policies Remove Whitelist Domain
- Policies Bulk Actions Actions
- Policy Ips Actions
- Scheduled Policies Actions
- Scheduled Report Previews Actions
- Scheduled Reports Actions
- Networks Actions
- Networks Lookup
- Networks Show
- Networks Update
- Networks Destroy
- Networks Bulk Create
- Networks Bulk Create Status
- Networks Index
- Networks Create
- Networks All
- Networks Msp
- Networks Msp All
- Networks Bulk Update
- Networks Bulk Update Status
- Networks Bulk Destroy
- Networks Bulk Destroy Status
- Networks Generate Secret Key
- Networks Revoke Secret Key
- Networks Rotate Secret Key
- Mac Addresses Actions
- Metrics Actions
- Network Lan Ips Actions
- Network Subnets Actions
- Organizations Actions
- Organization Users Actions
- Distributors Actions
- Distributors Msps Cancel
- Distributors Msps Reactivate
- Distributors Organizations Index
- Distributors Organizations Create
- Distributors Organizations Show
- Distributors Organizations Update
- Distributors Organizations Cancel
- Distributors Organizations Reactivate
- Distributors Organizations Add Sku
- Distributors Organizations Remove Sku
- Distributors Users Index
- Distributors Users Create
- Distributors Users Show
- Distributors Users Add Membership
- Distributors Users Update Membership
- Distributors Users Remove Membership
- Distributors Users Send Reset Password Email
- Distributors Users Reset Password Url
- Distributors Reports Usage By Organization
- Distributors Reports Usage By Sku
- Distributors Reports Covered Users Summary By Organization
- Distributors Distributors Update
- Distributors Msps Index
- Distributors Msps Create
- Distributors Msps Show
- Distributors Msps Update
- Domain Notes Actions
- Domains Actions
- Enterprise Connections Actions
- Invoices Actions
- IP Addresses Actions
- Allowed Urls Actions
- Api Key Actions
- Application Categories Actions
- Applications Actions
- Authentication Actions
- Authentication Sync Tool Actions
- Billings Actions
- Blocked Urls Actions
- Block Pages Actions
- Categories Actions
- Collection Users Actions
- Agent Local User Actions
- Agent Local User Bulk Deletes Actions
Overview
This node operation, "Distributors Msps Index," retrieves a list of Managed Service Providers (MSPs) associated with distributors. It allows filtering and querying MSPs based on various criteria such as creation date, cancellation status, distributor ID, MSP name, and other attributes. This is useful for scenarios where you need to analyze or report on MSPs managed by distributors, track their statuses, or integrate MSP data into workflows.
Practical examples include:
- Fetching all active MSPs created within a specific time range.
- Listing MSPs filtered by distributor SKU or status.
- Retrieving canceled MSPs only for audit or cleanup purposes.
- Paginating through large sets of MSP records for batch processing.
Properties
| Name | Meaning |
|---|---|
| Additional Query Parameters | Optional filters and parameters to refine the MSP search query. These include: - Canceled At From/To: Unix timestamp range for cancellation time (requires canceled filter). - Created At From/To: Unix timestamp range for creation time. - Distributor Id: Case-insensitive pattern to filter by distributor ID. - Distributor Sku: Case-sensitive exact match for distributor SKU. - Distributor Status: Case-sensitive exact match for distributor status. - External Id: Case-insensitive pattern for external ID. - Include Canceled: Boolean to include canceled MSPs (default true). Ignored if Only Canceled is true. - Msp Name: Case-insensitive pattern to filter MSP names. - Only Canceled: Boolean to filter only canceled MSPs (default true). - Page: JSON object specifying page number and size (defaults to 1 and 1500 respectively). - Parent Organization Name: Case-insensitive pattern for parent organization name. - Transferred At From/To: Unix timestamp range for transfer time. - Trial End: Exact ISO8601 date string to filter trial end date. - Updated At From/To: Unix timestamp range for last update time. |
Output
The node outputs JSON data representing the list of MSPs matching the query parameters. Each item in the output typically contains detailed information about an MSP, including identifiers, status, timestamps, and related distributor information.
If binary data were involved, it would be summarized here, but this operation focuses on JSON data retrieval.
Dependencies
- Requires an API key credential for authenticating requests to the external service managing distributor and MSP data.
- The node uses HTTP requests to communicate with the external API endpoint.
- No additional environment variables are explicitly required beyond the API authentication setup.
Troubleshooting
- Empty results: Ensure that the query parameters are correctly set and that the filters do not exclude all records unintentionally (e.g., conflicting date ranges or mutually exclusive flags like
include_canceledandonly_canceled). - Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Rate limiting or API errors: Check the external service's API limits and error messages; implement retries or backoff as needed.
- Invalid parameter formats: For date/time filters, ensure timestamps are Unix epoch numbers and dates are in ISO8601 format where required.
Links and References
- Refer to the external API documentation for detailed descriptions of each query parameter and response structure.
- n8n documentation on how to configure API credentials and use HTTP request nodes may help in setting up this node properly.