Actions42
- Incident Actions
- Change Actions
- Custom Business Object Actions
- Employee Actions
- Event Actions
- Task Actions
Overview
The Ivanti node's "Employee" resource with the "Update" operation allows you to update an existing employee (user) record in the Ivanti system. This is useful for automating HR processes, synchronizing user data between systems, or managing employee information programmatically. For example, you could use this node to update an employee's contact details, change their organizational unit, or modify authentication settings as part of an onboarding or offboarding workflow.
Properties
| Name | Meaning |
|---|---|
| Record ID | RecId value of the employee (user) in Ivanti. This uniquely identifies which employee record will be updated. |
| Use Predefined Fields | Whether object creation requires more predefined parameters. If enabled, you can specify standard fields such as name, email, and authentication options. |
| Predefined Fields | Collection of standard employee fields to update. Options include: - Auth (External): Whether authentication method is external - Auth (Internal): Whether authentication method is internal - Display Name - First Name - Last Name - Login Name - Manager (ID) - Organizational Unit (ID) - Password - Phone - Status - Team |
| Send Custom Fields | Whether creating object requires more custom parameters. If enabled, you can add custom fields to the update request. |
| Custom Fields | List of custom fields to set on the employee. Each field includes: - Field Name or ID: Name of the custom field - Field Value: Value to set on the custom field |
Output
- The node outputs a
jsonobject containing the response from the Ivanti API after updating the employee record. - The structure of the output depends on the Ivanti API's response for an update operation, typically including status, updated fields, and possibly the full employee record.
- No binary data is produced by this operation.
Dependencies
- External Service: Requires access to the Ivanti API endpoint.
- API Key/Credentials: Needs valid IvantiApi credentials configured in n8n, including the base URL.
- n8n Configuration: Ensure the Ivanti credential is set up with the correct base URL and permissions to update employee records.
Troubleshooting
- Missing or Invalid Record ID: If the "Record ID" is missing or incorrect, the API may return an error indicating that the employee was not found. Double-check the ID value.
- Authentication Errors: Invalid or expired credentials will result in authentication errors. Ensure your IvantiApi credentials are up to date.
- Field Validation Errors: Providing invalid values for certain fields (e.g., email format, required fields left blank) may cause the API to reject the update. Review the error message for details.
- Custom Field Issues: If a custom field name or value is incorrect or does not exist in Ivanti, the update may fail. Verify custom field definitions in your Ivanti instance.