Skip to main content

Get Value

Retrieves a value from a JSON object using a specified key.

Common Properties

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.

Inputs

  • Payload - JSON object from which to retrieve a value.
  • Key - The key of the value to retrieve from the JSON object.

Options

  • Escape - Whether to escape dots in the key name (useful for nested keys with dots).

Outputs

  • Value - The value retrieved from the JSON object using the specified key.

How It Works

The Get Value node retrieves a value from a JSON object using a specified key. When executed, the node:

  1. Receives a JSON object through the Payload input
  2. Receives a key name through the Key input
  3. Optionally escapes dots in the key name if the Escape option is enabled
  4. Retrieves the value associated with the specified key from the JSON object
  5. Outputs the retrieved value through the Value output

Requirements

  • Valid JSON object as input
  • Valid key name to retrieve

Error Handling

The node will return specific errors in the following cases:

  • Invalid JSON object in the Payload input
  • Invalid key name in the Key input

Usage Notes

  • This node is useful for extracting specific data from JSON objects
  • Works with nested JSON objects using dot notation (e.g., "user.name")
  • The Escape option is useful when key names contain dots that should be treated as literal characters
  • Can retrieve any type of value including strings, numbers, objects, arrays, and booleans
  • Works with any valid JSON structure
  • If the key doesn't exist, the node will return a null value
  • Useful for data extraction and processing workflows
  • Can be combined with other JSON nodes to build complex data processing pipelines
  • Supports deep nesting with multiple levels of dot notation (e.g., "user.profile.name")