IT Glue icon

IT Glue

Utilize the IT Glue API
Join our community

Actions34

Overview

This node integrates with the IT Glue API to perform various operations on different resources. Specifically, for the Organization resource and the Bulk Update operation, it allows users to update multiple organizations in a single request by providing an array of organization objects. Each object must include the organization's ID and the attributes to be updated.

This bulk update capability is useful when managing large sets of organizational data, such as updating names, descriptions, alerts, or other attributes across many organizations efficiently without making individual API calls for each one.

Practical Example

  • A user wants to update the name and alert message for several organizations at once.
  • They provide a JSON array where each element contains the organization's ID and the new values for the fields to update.
  • The node sends this batch update to IT Glue, streamlining the process and reducing API call overhead.

Properties

Name Meaning
Organizations to Update A JSON array of organization objects to update. Each object must contain the organization's ID and the attributes to update. Example: [{"ID": 1, "name": "Updated Name", "alert": "New alert"}, {"ID": 2, "description": "New description"}]

Output

The node outputs the response from the IT Glue API after performing the bulk update. The output is structured as JSON data representing the updated organizations or the result of the bulk update operation.

If the API supports returning binary data (e.g., attachments), the node would handle that accordingly, but for this operation, the output is primarily JSON reflecting the updated state of the organizations.

Dependencies

  • Requires an active connection to the IT Glue API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The node uses standard HTTP headers for JSON API communication (Accept: application/json, Content-Type: application/vnd.api+json).

Troubleshooting

  • Invalid JSON Input: If the JSON array provided in "Organizations to Update" is malformed or missing required IDs, the API will reject the request. Ensure the JSON is valid and each object includes an ID.
  • Authentication Errors: Missing or invalid API credentials will cause authorization failures. Verify that the API key credential is correctly set up in n8n.
  • Partial Updates Not Applied: If some updates fail due to validation errors on specific fields, the API might return error details. Review the error messages to correct attribute values.
  • API Rate Limits: Bulk operations may hit rate limits if performed frequently. Consider spacing out requests or batching smaller groups.

Links and References

Discussion