🎉 Pipedream raises $20M Series A 🎉
Read the blog post and TC Techcrunch article.
← Data Stores

Get record with Data Stores API

Pipedream makes it easy to connect APIs for Data Stores and 700+ other apps remarkably fast.

Trigger workflow on
HTTP requests, schedules and app events
Next, do this
Get record with the Data Stores API
No credit card required
Trusted by 250,000+ developers from startups to Fortune 500 companies:
Trusted by 250,000+ developers from startups to Fortune 500 companies

Developers Pipedream

Getting Started

Create a workflow to Get record with the Data Stores API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Configure the Get record action
    1. Connect your Data Stores account
    2. Configure Data Store
    3. Select a Key
    4. Optional- Select a Create a new record if the key is not found?
  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


This is a pre-built, open source 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.

Get record on Data Stores
Description:Get a single record in your [Pipedream Data Store](https://pipedream.com/data-stores/).


import app from "../../data_stores.app.mjs";

export default {
  key: "data_stores-get-record",
  name: "Get record",
  description: "Get a single record in your [Pipedream Data Store](https://pipedream.com/data-stores/).",
  version: "0.0.5",
  type: "action",
  props: {
    dataStore: {
      propDefinition: [
    key: {
      propDefinition: [
        ({ dataStore }) => ({
      description: "Key for the data you'd like to fetch. Refer to your existing keys [here](https://pipedream.com/data-stores/).",
    addRecordIfNotFound: {
      label: "Create a new record if the key is not found?",
      description: "Create a new record if no records are found for the specified key.",
      type: "string",
      options: [
      optional: true,
      reloadProps: true,
  async additionalProps() {
    const props = {};
    if (this.addRecordIfNotFound === "Yes") {
      props["value"] = {
        label: "Value",
        type: "any",
        description: "Enter a string, object, or array.",
    return props;
  async run({ $ }) {
    const record = await this.dataStore.get(this.key);

    if (record) {
      $.export("$summary", "Found data for the key, `" + this.key + "`.");
    } else {
      if (this.addRecordIfNotFound === "Yes") {
        await this.dataStore.set(this.key, this.value);
        $.export("$summary", "Successfully added a new record with the key, `" + this.key + "`.");
        return this.dataStore.get(this.key);
      } else {
        $.export("$summary", "No data found for key, `" + this.key + "`.");

    return record;


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.
Data StoresappappThis component uses the Data Stores app.
Data StoredataStoredata_store

Select an existing Data Store or create a new one.

KeykeystringSelect a value from the drop down menu.
Create a new record if the key is not found?addRecordIfNotFoundstringSelect a value from the drop down menu:YesNo


The Data Stores API does not require authentication.

About Data Stores

Use Pipedream Data Stores to manage state throughout your workflows.

About Pipedream

Stop writing boilerplate code, struggling with authentication and managing infrastructure. Start connecting APIs with code-level control when you need it — and no code when you don't.

Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜
"The past few weeks, I truly feel like the clichéd 10x engineer."