Actions42
- Incident Actions
- Change Actions
- Custom Business Object Actions
- Employee Actions
- Event Actions
- Task Actions
Overview
This node allows you to create a Custom Business Object in Ivanti via its API. It is useful when you need to automate the creation of custom records or objects within your Ivanti environment, especially when standard resources do not fit your use case. For example, you might use this node to automatically add new entries to a custom asset tracking object or log specialized business events.
Properties
| Name | Meaning |
|---|---|
| Business Object Name | The name or ID of the custom business object you want to create. This identifies which type of custom record will be created in Ivanti. |
| Send Custom Fields | Whether creating the object requires additional custom parameters. Set to true if you need to provide extra fields beyond the default ones. |
| Custom Fields | A collection of custom fields to set on the new business object. Each entry includes: - Field Name or ID: The name/ID of the custom field. - Field Value: The value to assign to that field. |
Output
- The output will contain the JSON response from the Ivanti API after attempting to create the custom business object.
- The structure of the output JSON will reflect the data returned by Ivanti for the newly created object, typically including identifiers and any fields set during creation.
- If binary data is ever returned (unlikely for this operation), it would represent the raw API response.
Dependencies
- Ivanti API: Requires access to an Ivanti instance with API enabled.
- API Credentials: You must configure n8n with valid Ivanti API credentials (
IvantiApi). - Environment Variable: The base URL for the Ivanti API must be set in the credentials as
baseUrl.
Troubleshooting
Common Issues:
- Invalid Business Object Name: Ensure the "Business Object Name" matches exactly with what exists in Ivanti.
- Missing Required Fields: If required custom fields are not provided, the API may reject the request.
- Authentication Errors: Make sure your API credentials are correct and have sufficient permissions.
Error Messages:
- "Resource not found" – Check the "Business Object Name" for typos.
- "Unauthorized" – Verify your API credentials and permissions.
- "Validation failed" – Review the custom fields and ensure all required values are supplied and correctly formatted.