# Convert list to object transform action ## Overview

This transform action allows you to convert a list of objects into a single object, creating each object's property using user-defined key-value pairs extracted from the list, and simplifying the handling of complicated list structures.

## Parameters

Parameter	Description	Required	Required
List to Transform	The list of objects you want to transform into a single object. Each item in the list should be a object with key-value pairs.	true	true
Field to use as Key	The field name from the items in your list that you want to use as keys in your new object.	true	true
Field to use as Value	The field name from the items in your list that you want to use as values in your new object.	true	true

{% hint style="info" %} For nested field names, separate them by dots (e.g., `details.age`). {% endhint %} ## Usage The `Convert List to Object` transform provides a powerful way to reshape your data to meet specific requirements. The ability to define keys and values, including the ability to access nested data, makes it versatile for a range of scenarios. Let's go through a couple of use-case examples to demonstrate how this transform can be applied to your data.

Example 1: Simple Key-Value Conversion

Let's assume we have this list of objects called `mylist`: ```json mylist: [ { name: "John", age: 30, hobbies: ["golf", "reading"], }, { name: "Mary", age: 35, hobbies: ["cooking", "music"], }, ] ``` **Action Parameters:** We want to create a new object where the keys are the `name` field and the values are the `age` field. We would use the following parameters: ```json key_field: name value_field: age ``` **Jinja2 Equivalent:** ```jinja2 {% set new_object = {} %} {% for item in mylist %} {% set _ = new_object.update({item['name']: item['age']}) %} {% endfor %} ```

Example 2: Nested Key-Value Conversion

Now, let's consider a list of objects where some fields are nested: ```json mylist: [ { name: "John", details: { age: 30, occupation: "Engineer" }, hobbies: ["golf", "reading"], }, { name: "Mary", details: { age: 35, occupation: "Doctor" }, hobbies: ["cooking", "music"], }, ] ``` **Action Parameters:** In this case, the `age` field is nested under the `details` object. So, to create an object where the keys are the `name` field and the values are the `age` field nested under `details`, we would use the following parameters: ```json key_field: name value_field: details.age ``` **Jinja2 Equivalent:** ```jinja2 {% set new_object = {} %} {% for item in mylist %} {% set _ = new_object.update({item['name']: item['details']['age']}) %} {% endfor %} ```

## Results output In both of these examples, your new output object would look as follows: ```json results: { "John": 30, "Mary": 35 } ``` {% hint style="info" %} *This transform is especially useful when dealing with data structures like ConnectWise PSA Custom Fields or Communication Items.* {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.rewst.help/documentation/automations/actions-in-rewst/transform-actions/convert-to-object.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.