Autotask icon

Autotask

Consume Autotask REST API

Actions389

Overview

This node operation retrieves a specific Contract Note from the Autotask system by its unique Note ID. It is useful for workflows that need to fetch detailed information about a particular contract note, such as auditing contract changes, displaying contract note details in dashboards, or integrating contract note data with other systems.

Properties

Name Meaning
Note ID The unique identifier of the contract note to retrieve. This is a required field to specify which note to get.
Add Picklist Labels Determines whether to automatically add human-readable "_label" fields for picklist fields in the response. This helps in understanding picklist values without needing to decode them manually.
Add Reference Labels Determines whether to automatically add human-readable "_label" fields for reference fields in the response. This makes reference fields easier to interpret.
Select Columns Names or IDs. Allows selection of specific fields to include in the response. If no fields are selected, all fields are returned. The Note ID field is always included regardless of selection.
Flatten User-Defined Fields If enabled, user-defined fields (UDFs) are brought to the top level of the returned object instead of being nested inside a userDefinedFields array, simplifying access to these fields.

Output

JSON

  • id - The unique identifier of the contract note.
  • subject - The subject or title of the contract note.
  • description - Detailed description or content of the contract note.
  • createdDate - The date and time when the contract note was created.
  • modifiedDate - The date and time when the contract note was last modified.
  • userDefinedFields - An array of user-defined fields associated with the contract note, unless flattened.
    _label - Human-readable labels for picklist or reference fields, if enabled.

Dependencies

  • Requires an API key credential for Autotask REST API authentication.

Troubleshooting

  • If the Note ID is missing or invalid, the node will throw an error indicating the note could not be found. Ensure the Note ID is correct and exists in Autotask.
  • If API authentication fails, verify that the API key credential is correctly configured and has sufficient permissions.
  • Selecting invalid or unsupported fields in 'Select Columns' may result in incomplete or error responses. Use the provided dropdown or valid field IDs.
  • If picklist or reference labels are not appearing as expected, check that the corresponding options 'Add Picklist Labels' and 'Add Reference Labels' are enabled.

Discussion