Use Add an item to a list to let an AI Agent create records in a selected data list. For example, a service desk agent can create a request using the subject and priority supplied by a user.
Accessing the Tools Page
Open the AI Agent and select Tools in the top navigation. You can add, edit, enable, disable, or remove tools from this page.
Adding the “Add an item to a list” Tool
Select Add a tool → Add an item to a list.
Choose the application, then choose the destination list under Data source.
Select Add to create the tool or Add and configure to open its settings.
General Settings
Under Details, check the tool name, description, type, application, and data source. Set Credentials to use to End user credentials for the caller’s access or Specific user for the selected user’s access. The identity must be able to create records in the selected list. AI Agent settings
Inputs – Fields Used When Creating a New Item
The Inputs list starts empty. Select + Add input to choose which fields the agent can fill. To look up records without creating one, use the query tool. Configure Query Items
Select inputs
The picker shows each field’s Input name, internal ID, and Input type. Select the fields needed for creation and choose OK. For a service desk request, let the agent extract Subject from the conversation. If all requests created through the agent have the same source, set a custom value for Source.
Inputs table configuration
Each selected input appears as a row with:
Column | Description |
Input name | Name of the field the agent will fill |
Input type | Data type inherited from the list |
Fill using | AI-generated value or Custom value |
Value | Shown only when using Custom value |
Notes:
Required list fields should be included.
Only fields added here can be populated by the agent.
Fields can be removed anytime using the delete icon.
Note:
To learn more about the Dynamically fill with AI and Custom value options, please refer to the following article: Usage and Differences Between “Dynamically fill with AI” and “Custom value” in AI Agent Tool Inputs
Completion
Under After running, choose Waiting for response when the agent needs to confirm the creation result. Use the non-waiting option when the agent can continue without the result.
Outputs available to the agent and other tools
Defines which outputs from this tool will be available for use by the agent or other tools after an item is created.
Default outputs include:
Output | Output type | Description |
Message | Text | Describes the execution result (success or error). |
Status Code | Number | Indicates success or failure numerically. |
Managing outputs
Select Customize to change an output mapping. Remove unused outputs and select Add output if you need to restore one. If the configuration also shows Data, inspect its value in a test run before using it in a later step.
Summary
In a test list, submit a request with a unique subject and a valid priority. Check that the list contains one new record with the expected subject, priority, and source.
Try a request with a required value missing. Check whether the agent asks for it before calling the tool or reports an error if creation fails.
If you use End user credentials, check the result with a user who can create records and one who can only read the list.

