@joshuanode/n8n-nodes-immybot

This is an n8n community node for ImmyBot, the intelligent IT automation and management platform. It enables automated workflows for computer management, software deployment, maintenance actions, and more within n8n.

Features

• Computer Management - 20+ operations for inventory, status monitoring, configuration, and bulk actions
• Change Request Workflow - Approve, deny, require changes, and comment on change requests
• Multi-Tenant Support - Manage resources across multiple tenants
• Multi-Select Pickers - Visual dropdowns for bulk operations with dynamic API-loaded lists
• Server-Side Filtering - Filter by name and tenant at the API level to reduce data transfer
• Software & Script Management - Manage global/local software and deployment scripts with pagination
• User Management - 12 operations for user lifecycle, roles, permissions, and access control
• Tag & Person Management - Organize computers with tags and associate users
• Sync Operations - Trigger Azure user sync and user affinity sync

Installation

Community Nodes (Recommended)

1. Open n8n and navigate to Settings → Community Nodes
2. Click Install and search for @joshuanode/n8n-nodes-immybot
3. Click Install to add the node to your n8n instance

Manual Installation

npm install @joshuanode/n8n-nodes-immybot

Credentials

Setting up Immy.Bot OAuth2 API Credentials

This node uses Azure AD OAuth2 authentication. To configure:

1. Create Azure AD App Registration:

   • Navigate to Microsoft Entra ID
   • Go to App registrations → New registration
   • Enter a name (e.g., "n8n ImmyBot Integration")
   • Use default settings and click Register

2. Generate Client Secret:

   • In your app registration, go to Certificates & secrets
   • Click New client secret
   • Add a description and expiration period
   • Copy the Value (not the Secret ID)

3. Collect Required Information:

   • Azure AD Tenant ID: Found in your app registration's Overview page
   • Client ID: The Application (client) ID from Overview
   • Client Secret: The value you copied in step 2
   • ImmyBot Subdomain: Your ImmyBot subdomain (e.g., "yourcompany" for yourcompany.immy.bot)

4. Configure in n8n:

   • Create a new Immy.Bot OAuth2 API credential
   • Enter the Azure AD Tenant ID, Client ID, Client Secret, and Subdomain
   • Test the connection

For detailed setup instructions, see the ImmyBot API Documentation.

Note: The OAuth2 token is automatically acquired and refreshed by the node.

Operations by Resource

Change Request (7 operations)

| Operation | Description | |-----------|-------------| | Approve | Approve a change request | | Deny | Deny a change request with optional reason | | Require Changes | Request changes to a change request with comment | | Comment | Add a comment to a change request | | Delete | Delete a change request | | Get Many | List change requests with status filtering and pagination | | Get Open Count | Get count of open change requests |

Computer (20 operations)

| Operation | Description | |-----------|-------------| | Get | Retrieve a single computer by ID | | Get Many | List computers with server-side filtering by name and tenant | | Update | Update computer properties including name, tenant, and maintenance settings | | Get Status | Get current status and health information for a computer | | Get Events | Retrieve event history for a computer | | Get Detected Software | List all software detected on a computer | | Get Inventory | Retrieve inventory data across all computers | | Get Inventory Script Results | Get results from custom inventory scripts | | Get User Affinities | View user affinity relationships across computers | | Get Agent Status | Check ImmyBot agent connectivity status | | Add Tags | Add tags to multiple computers using visual multi-select picker | | Remove Tags | Remove tags from multiple computers using visual multi-select picker | | Change Tenant | Move multiple computers to a different tenant with multi-select | | Bulk Delete | Delete multiple computers at once with multi-select picker | | Restore | Restore previously deleted computers with multi-select picker | | Reinventory | Trigger a new inventory scan for a computer | | Set to Needs Onboarding | Mark a computer for onboarding | | Skip Onboarding | Skip the onboarding process for multiple computers with multi-select | | Update Primary Person | Assign or update the primary user for a computer | | Update Additional Persons | Manage multiple additional users with multi-select person picker |

Tenant (5 operations)

| Operation | Description | |-----------|-------------| | Get | Retrieve a single tenant by ID | | Get Many | List all tenants | | Create | Create a new tenant | | Update | Update tenant properties | | Bulk Delete | Delete multiple tenants |

Software (8 operations)

| Operation | Description | |-----------|-------------| | Get Global Software | Retrieve global software by identifier | | Get Local Software | Retrieve local software by identifier | | Get Many Global | List global software items with pagination | | Get Many Local | List local software items with pagination | | Create Global Software | Create a new global software item | | Create Local Software | Create a new local software item | | Delete Global Software | Delete a global software item | | Delete Local Software | Delete a local software item |

Sync (2 operations)

| Operation | Description | |-----------|-------------| | Trigger Azure User Sync | Trigger Azure user synchronization for tenants | | Trigger User Affinity Sync | Trigger user affinity synchronization |

User (12 operations)

| Operation | Description | |-----------|-------------| | Get | Retrieve a user by ID | | Get Many | List users with pagination | | Create from Person | Create a user account from a person record | | Update | Update user details | | Delete | Delete a user account | | Bulk Delete | Delete multiple users at once | | Get Claims | Retrieve user claims and permissions | | Add Roles | Add roles to a user | | Remove Roles | Remove roles from a user | | Grant Access | Grant tenant access to a user | | Update Expiration | Update user access expiration date | | Invalidate Cache | Invalidate user cache |

Maintenance Action (2 operations)

| Operation | Description | |-----------|-------------| | Get Latest for Computer | Get the most recent maintenance action for a computer | | Get Many | List maintenance actions across all computers |

Person (2 operations)

| Operation | Description | |-----------|-------------| | Get | Retrieve person details by ID | | Get Many | List all persons |

Script (3 operations)

| Operation | Description | |-----------|-------------| | Get Global Script | Retrieve a global script by ID | | Get Local Script | Retrieve a local script by ID | | Get Many | List scripts with database type filtering (Global, Local, or Both) and pagination |

Tag (2 operations)

| Operation | Description | |-----------|-------------| | Get | Retrieve tag details by ID | | Get Many | List all tags |

Usage Examples

Monitor Computer Health

Schedule → Get Many Computers → Filter (Offline) → Send Alert

Software Inventory Report

Schedule → Get Many Computers → Get Detected Software → Export CSV

Bulk Tenant Migration

Manual Trigger → Get Many Computers (Filter by Tenant) → Change Tenant

Additional Details

Resource Locators - All ID-based parameters support three input modes: searchable dropdown (From List), direct ID entry (By ID), or URL extraction (By URL for computers).

Server-Side Filtering - Filter computers by name and tenant at the API level. For additional filtering (online/offline status, etc.), use n8n's Filter node after retrieving data.

Multi-Select Pickers - Bulk operations feature visual multi-select dropdowns for computers, tags, and persons, loaded dynamically from your ImmyBot instance.

Pagination - All list operations support "Return All" or configurable limits (1-500) to efficiently handle large datasets.

Resources

• ImmyBot Documentation
• ImmyBot API Reference
• n8n Community Nodes Documentation
• n8n Node Development Guide

Compatibility

• n8n version: 0.220.0 or later
• Node.js version: 18.17.0 or later
• ImmyBot API: v1

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues, questions, or feature requests, please:

1. Check the ImmyBot Documentation
2. Review existing GitHub Issues
3. Create a new issue with detailed information about your problem or request

Acknowledgments

Built with the n8n-node-dev CLI tool.

Note: This is a community-maintained node and is not officially supported by ImmyBot or n8n.io.