Ivanti icon

Ivanti

Interact with Ivanti API
Join our community

Actions42

Overview

The Ivanti node for n8n allows you to interact with the Ivanti API, specifically to create new Employee records. This operation is useful in automated workflows where you need to onboard new users, synchronize employee data between systems, or programmatically manage your organization's user directory.

Practical examples:

  • Automatically create a new employee record in Ivanti when a new hire is added to your HR system.
  • Batch import employees from a CSV file into Ivanti.
  • Integrate with onboarding workflows to set up user accounts with predefined roles and custom attributes.

Properties

Name Meaning
First Name First name of the employee (user). Required.
Last Name Last name of the employee (user). Required.
Login Name Unique login name of the employee (user). Required.
Email Unique primary email address of the employee (user). Required.
Use Predefined Fields Whether object creation requires more predefined parameters. If enabled, additional fields become available.
Predefined Fields Collection of additional standard fields:
- Auth (External): Whether authentication method is external
- Auth (Internal): Whether authentication method is internal
- Display Name: Display name of the employee
- Manager (ID): ID of the manager
- Organizational Unit (ID): Organization unit ID
- Password: Password of the employee
- Phone: Primary phone number
- Team: Team assignment
Send Custom Fields Whether creating the object requires more custom parameters. If enabled, "Custom Fields" becomes available.
Custom Fields List of custom fields to set on the employee. Each field has:
- Field Name or ID: Name of the custom field
- Field Value: Value to assign

Output

The node returns the response from the Ivanti API after attempting to create the employee. The structure of the json output field will typically include:

  • Details of the newly created employee record as returned by the Ivanti API.
  • Any error messages or status codes if the creation fails.

Example output:

{
  "FirstName": "John",
  "LastName": "Doe",
  "LoginID": "jdoe",
  "PrimaryEmail": "john.doe@example.com",
  // ...other fields as provided and returned by the API
}

Note: The exact structure depends on the Ivanti API's response.

Dependencies

  • External Service: Requires access to an Ivanti instance with API enabled.
  • API Credentials: You must configure the IvantiApi credential in n8n, including the base URL and authentication details.
  • n8n Configuration: No special environment variables are required beyond the credential setup.

Troubleshooting

Common issues:

  • Missing Required Fields: If any required property (First Name, Last Name, Login Name, Email) is missing, the API will likely return an error.
  • Invalid Credentials: Incorrect or missing API credentials will result in authentication errors.
  • Field Validation Errors: Providing invalid values (e.g., duplicate login name, malformed email) may cause the API to reject the request.

Common error messages:

  • "401 Unauthorized": Check your API credentials and permissions.
  • "400 Bad Request": Ensure all required fields are filled and values are valid.
  • "409 Conflict": The login name or email already exists; use unique values.

Links and References

Discussion