Amazon DynamoDB integration | Flomation Support

00Overview

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Amazon DynamoDB

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
Region	`string`	Required	eu-west-1
AWS Access Key	`string`	Required
AWS Secret Key	`string`	Required

Good to know

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Dynamodb

DynamoDB Query

aws/dynamodb · Action

Execute an operation against an AWS DynamoDB table

Field	Type		Details
Table Name	`string`	Required
Operation	`string`	Required	choices: Get Item, Put Item, Query, Scan, Delete Item
Key	`text`	Required	{"pk": {"S": "value"}}
Data	`text`		{"attribute": {"S": "value"}}
Filter Expression	`string`

Returns: tool_result, results, count

03Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

The Key and Data fields must be written in DynamoDB's typed JSON, wrapping every value with its attribute type, such as {"pk": {"S": "text"}} for a string or {"N": "42"} for a number.
Scan reads every item in the table and grows slower and more costly as the table fills up, so prefer Query whenever you know the item's key.
Query and Scan return at most 1 MB of matching data per run, so very large result sets can come back partial and may need to be narrowed.
Reads are eventually consistent by default, so an item written moments earlier may not yet appear in a Get, Query, or Scan.
The Filter Expression is applied after items are read, so it reduces what you receive but not the amount of data the table works through underneath.
Put Item replaces the entire matching item rather than merging, so any attributes left out of the Data field are lost.