DynamoDB - Query with AWS API

Pipedream makes it easy to connect APIs for AWS and 1200+ other apps remarkably fast.

Trigger workflow on
HTTP requests, schedules and app events
Next, do this
DynamoDB - Query with the AWS API
No credit card required
Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜

Trusted by 500,000+ developers from startups to Fortune 500 companies

Adyen logo
Brex logo
Carta logo
Checkr logo
Chameleon logo
DevRev logo
LinkedIn logo
Netflix logo
New Relic logo
OnDeck logo
Replicated logo
Scale AI logo
Teamwork logo
Warner Bros. logo
Xendit logo

Developers Pipedream

Getting Started

Create a workflow to DynamoDB - Query with the AWS API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Configure the DynamoDB - Query action
    1. Connect your AWS account
    2. Select a AWS Region
    3. Select a Table Name
    4. Configure Key Condition Expression
    5. Optional- Configure Projection Expression
    6. Optional- Configure Expression Attribute Names
    7. Optional- Configure Expression Attribute Values
  2. Select a trigger to run your workflow on HTTP requests, schedules or app events
  3. Deploy the workflow
  4. Send a test event to validate your setup
  5. Turn on the trigger


DynamoDB - Query with AWS API on New Requests (Payload Only) from HTTP / Webhook API
HTTP / Webhook + AWS
Try it
DynamoDB - Query with AWS API on New Item in Feed from RSS API
Try it
DynamoDB - Query with AWS API on New Message from Discord API
Discord + AWS
Try it
DynamoDB - Query with AWS API on New Message In Channels from Slack API
Slack + AWS
Try it
DynamoDB - Query with AWS API on New Message in Channel from Discord Bot API
Discord Bot + AWS
Try it


This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

DynamoDB - Query on AWS
Description:The query operation finds items based on primary key values. [See docs](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-dynamodb/classes/querycommand.html)


import common from "../../common/common-dynamodb.mjs";
import {
} from "../../common/utils.mjs";

export default {
  key: "aws-dynamodb-query",
  name: "DynamoDB - Query",
  description: toSingleLineString(`
    The query operation finds items based on primary key values.
    [See docs](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-dynamodb/classes/querycommand.html)
  version: "0.5.0",
  type: "action",
  props: {
    aws: common.props.aws,
    region: common.props.region,
    tableName: common.props.tableName,
    keyConditionExpression: common.props.keyConditionExpression,
    projectionExpression: common.props.projectionExpression,
    expressionAttributeNames: common.props.expressionAttributeNames,
    expressionAttributeValues: common.props.expressionAttributeValues,
  async run({ $ }) {
    const params = {
      TableName: this.tableName,
      KeyConditionExpression: this.keyConditionExpression,
      ProjectionExpression: this.projectionExpression,
      ExpressionAttributeNames: attemptToParseJSON(this.expressionAttributeNames),
      ExpressionAttributeValues: attemptToParseJSON(this.expressionAttributeValues),

    const response = await this.aws.pagination(

    const s = response.Items.length === 1
      ? ""
      : "s";
    $.export("$summary", `Query returned ${response.Items.length} item${s}`);
    return response;


This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
AWSawsappThis component uses the AWS app.
AWS RegionregionstringSelect a value from the drop down menu.
Table NametableNamestringSelect a value from the drop down menu.
Key Condition ExpressionkeyConditionExpressionstring

The condition that specifies the key values for items to be retrieved by the Query action. Example: partitionKeyName = :partitionkeyval AND sortKeyName = :sortkeyval See the docs

Projection ExpressionprojectionExpressionstring

A string that identifies one or more attributes to retrieve from the specified table or index. If no attribute names are specified, then all attributes will be returned. If any of the requested attributes are not found, they will not appear in the result.

Expression Attribute NamesexpressionAttributeNamesstring

One or more substitution tokens for attribute names in an expression. Example: { "#execs": "execs" } See the docs

Expression Attribute ValuesexpressionAttributeValuesstring

One or more values that can be substituted in an expression. Use the : (colon) character in an expression to dereference an attribute value. Example: { ":echo": { "S": "echo" }, ":oneh": { "N": "100" } } See the docs


AWS uses API keys for authentication. When you connect your AWS account, Pipedream securely stores the keys so you can easily authenticate to AWS APIs in both code and no-code steps.

Follow the AWS Instructions for creating an IAM user with an associated access and secret key.

As a best practice, attach the minimum set of IAM permissions necessary to perform the specific task in Pipedream. If your workflow only needs to perform a single API call, you should create a user and associate an IAM group / policy with permission to do only that task. You can create as many linked AWS accounts in Pipedream as you'd like.

Enter your access and secret key below.

About AWS

On-demand cloud computing platforms and APIs

More Ways to Use AWS


New Scheduled Tasks from the AWS API

Creates a Step Function State Machine to publish a message to an SNS topic at a specific timestamp. The SNS topic delivers the message to this Pipedream source, and the source emits it as a new event.

Try it
New SNS Messages from the AWS API

Creates an SNS topic in your AWS account. Messages published to this topic are emitted from the Pipedream source.

Try it
New Inbound SES Emails from the AWS API

The source subscribes to all emails delivered to a specific domain configured in AWS SES. When an email is sent to any address at the domain, this event source emits that email as a formatted event. These events can trigger a Pipedream workflow and can be consumed via SSE or REST API.

Try it
New Deleted S3 File from the AWS API

Emit new event when a file is deleted from a S3 bucket

Try it
New DynamoDB Stream Event from the AWS API

Emit new event when a DynamoDB stream receives new events. See the docs here

Try it


CloudWatch Logs - Put Log Event with the AWS API

Uploads a log event to the specified log stream. See docs

Try it
DynamoDB - Create Table with the AWS API

Creates a new table to your account. See docs

Try it
DynamoDB - Execute Statement with the AWS API

This operation allows you to perform transactional reads or writes on data stored in DynamoDB, using PartiQL. See docs

Try it
DynamoDB - Get Item with the AWS API

The Get Item operation returns a set of attributes for the item with the given primary key. If there is no matching item, Get Item does not return any data and there will be no Item element in the response. See docs

Try it
DynamoDB - Put Item with the AWS API

Creates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new item already exists in the specified table, the new item completely replaces the existing item. See docs

Try it

Explore Other Apps

apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
Trigger workflows on an interval or cron schedule.
Data Stores
Data Stores
Use Pipedream Data Stores to manage state throughout your workflows.
Telegram Bot
Telegram Bot
Telegram is a cloud-based instant messaging and voice over IP service
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular apps like ChatGPT and DALL·E 2.
Google Sheets
Google Sheets
With Google Sheets, you can create, edit, and collaborate wherever you are
Use this app to create a Discord source that emits messages from your guild to a Pipedream workflow.
Where the world builds software. Millions of developers and companies build, ship, and maintain their software on GitHub—the largest and most advanced development platform in the world.
Pre-built actions to make formatting and manipulating data within your workflows easier.
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.