IT Glue icon

IT Glue

Utilize the IT Glue API
Join our community

Actions34

Overview

This node interacts with the IT Glue API to retrieve multiple contact records based on specified filters and options. It is useful for scenarios where you need to fetch a list of contacts from your IT Glue account, optionally filtered by attributes such as name, organization, or creation date, and sorted in a particular order. For example, you might use this node to generate a report of all contacts created within a certain timeframe or to synchronize contact data with another system.

Properties

Name Meaning
Return All Whether to return all matching contact results or limit the number of returned items.
Limit The maximum number of contact results to return when "Return All" is false. Minimum value is 1.
Filters Criteria to filter the contacts by various fields:
- Contact Type ID
- Created At (ISO date)
- First Name
- Last Name
- Organization ID
- Title (job title)
- Updated At (ISO date)
Options Additional options for the query:
- Include related resources: Contact Type, Organization, Passwords
- Sort order of results: Created (newest/oldest), First Name (A-Z/Z-A), Last Name (A-Z/Z-A), Updated (newest/oldest)

Output

The node outputs an array of contact objects in the json field. Each object represents a contact record retrieved from IT Glue, including fields such as names, IDs, titles, and any included related resources (e.g., contact type, organization, passwords) if requested. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the IT Glue API.
  • The node uses the IT Glue REST API v1 with JSON:API content type.
  • No additional external dependencies are required beyond the configured API authentication.

Troubleshooting

  • Common issues:
    • Incorrect or missing API credentials will cause authentication failures.
    • Using invalid filter values (e.g., malformed dates) may result in API errors or empty results.
    • Requesting too many records without enabling "Return All" may truncate results unexpectedly.
  • Error messages:
    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Validation errors on filters suggest incorrect input formats; ensure ISO date strings and valid IDs.
    • Rate limiting errors from the API require implementing retry logic or reducing request frequency.

Links and References

Discussion