# DynamoDB PutItem Action

It provides a way to Insert Single Item in DynamoDB. Before adding DynamoDB PutItem Action, user has to define a [**AWS Connection**](/connections/aws-connection.md). User need to provide following parameters to add DynamoDB PutItem Action.

#### TableName

User's DynamoDB Tablename

#### Function

* User can write a JavaScript code to create "DynamoDB Item".
* "payload" object and "item" object is available in this code. Item object should hold key-value data pairs. Keys are DynamoDB column names and Values are corresponding string/number/boolean values.
* "payload" object is supplied from Action Trigger like Rules, Action Command etc.

```
item["Customer"] = payload.customer; // value from payload 
//OR
item["Customer"] = "abc";   //"some static value"

//Here 'Customer' is DynamoDB column name and payload.customer is it's value.
```

#### Connection ID

Connection ID of AWS Connection.

![Add DynamoDB PutItem Action](/files/4pJ6KkfCE8S1r4FGAsY1)

Please note the following points:

{% hint style="info" %}

* "payload" object is supplied from Action Trigger like Rules, Action Command etc.
* Data Response of PutItem will be available as Action Response.
* Find more details about PutItem in [AWS Doc](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html)
  {% 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.thingsup.io/actions/dynamodb-putitem-action.md?ask=<question>
```

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.