Add or update a single record with Data Stores API on New Custom Event from UpKeep API

Pipedream makes it easy to connect APIs for Data Stores, UpKeep and 2,000+ other apps remarkably fast.

Trigger workflow on

New Custom Event from the UpKeep API

Next, do this

Add or update a single record with the Data Stores API

No credit card required

▶

Watch us build a workflow

4 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a UpKeep trigger and Data Stores action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Custom Event trigger
1. Connect your UpKeep account
2. Select one or more Event types
Configure the Add or update a single record action
1. Connect your Data Stores account
2. Configure Data Store
3. Select a Key
4. Configure Value
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are 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.

Trigger#

New Custom Event on UpKeep

Description:Emit new event when a configured event occurs.

Version:0.0.2

Key:upkeep-new-custom-events

View on GitHub

UpKeep Overview#

The UpKeep API enables users to seamlessly integrate maintenance management tasks with Pipedream's serverless execution platform. By leveraging UpKeep's endpoints, you can automate workflows related to asset tracking, work order management, and preventive maintenance scheduling. The API's capabilities allow for real-time updates on equipment status, automated notifications for maintenance tasks, and data synchronization across maintenance teams and tools.

Trigger Code#

import common from "../common/common.mjs";
import eventTypes from "../common/eventTypes.mjs";

export default {
  key: "upkeep-new-custom-events",
  name: "New Custom Event",
  description: "Emit new event when a configured event occurs.",
  version: "0.0.2",
  type: "source",
  dedupe: "unique",
  ...common,
  props: {
    ...common.props,
    events: {
      type: "string[]",
      label: "Event types",
      description: "Select from available UpKeep event types.",
      options: eventTypes,
    },
  },
  methods: {
    ...common.methods,
    getTitle() {
      return "Pipedream - New Events";
    },
    getEvents() {
      return this.events;
    },
    getSummary(item) {
      return `New custom event (ITEM ID:${item?.id})`;
    },
    getTime() {
      return new Date().getTime();
    },
  },
};

Trigger Configuration#

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.

Label	Prop	Type	Description
UpKeep	`app`	`app`	This component uses the UpKeep app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Event types	`events`	`string[]`	Select a value from the drop down menu:`{ "label": "Work Order Created", "value": "WORK_ORDER_CREATED" }{ "label": "Work Order Updated", "value": "WORK_ORDER_UPDATED" }{ "label": "Work Order Status Updated", "value": "WORK_ORDER_STATUS_UPDATED" }{ "label": "Work Order Deleted", "value": "WORK_ORDER_DELETED" }{ "label": "PM Work Order Created", "value": "PM_WORK_ORDER_CREATED" }{ "label": "PM Work Order Updated", "value": "PM_WORK_ORDER_UPDATED" }{ "label": "PM Work Order Deleted", "value": "PM_WORK_ORDER_DELETED" }{ "label": "Work Order Schedule Created", "value": "WORK_ORDER_SCHEDULE_CREATED" }{ "label": "Work Order Schedule Updated", "value": "WORK_ORDER_SCHEDULE_UPDATED" }{ "label": "Work Order Schedule Status Updated", "value": "WORK_ORDER_SCHEDULE_STATUS_UPDATED" }{ "label": "Work Order Schedule Deleted", "value": "WORK_ORDER_SCHEDULE_DELETED" }{ "label": "Purchase Order Updated", "value": "PURCHASE_ORDER_UPDATED" }{ "label": "Purchase Order Created", "value": "PURCHASE_ORDER_CREATED" }{ "label": "Purchase Order Deleted", "value": "PURCHASE_ORDER_DELETED" }{ "label": "Purchase Order Approved", "value": "PURCHASE_ORDER_APPROVED" }{ "label": "Purchase Order Declined", "value": "PURCHASE_ORDER_DECLINED" }{ "label": "Request Created", "value": "REQUEST_CREATED" }{ "label": "Request Updated", "value": "REQUEST_UPDATED" }{ "label": "Request Approved", "value": "REQUEST_APPROVED" }{ "label": "Request Rejected", "value": "REQUEST_REJECTED" }`

Trigger Authentication#

UpKeep uses OAuth authentication. When you connect your UpKeep account, Pipedream will open a popup window where you can sign into UpKeep and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any UpKeep API.

Pipedream requests the following authorization scopes when you connect your account:

About UpKeep#

The #1 Software for Maintenance and Facility Management Teams. UpKeep is the top-rated software designed to revolutionize maintenance and asset management. We provide mobile-first SaaS solutions, Industrial IoT sensors, powerful data analytics, advanced enterprise integrations, and top-notch professional services.

Action#

Add or update a single record on Data Stores

Description:Add or update a single record in your [Pipedream Data Store](https://pipedream.com/data-stores/).

Version:0.0.9

Key:data_stores-add-update-record

View on GitHub

Data Stores Overview#

Data Stores are a key-value store that allow you to persist state and share data across workflows. You can perform CRUD operations, enabling dynamic data management within your serverless architecture. Use it to save results from API calls, user inputs, or interim data; then read, update, or enrich this data in subsequent steps or workflows. Data Stores simplify stateful logic and cross-workflow communication, making them ideal for tracking process statuses, aggregating metrics, or serving as a simple configuration store.

Action Code#

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

export default {
  key: "data_stores-add-update-record",
  name: "Add or update a single record",
  description: "Add or update a single record in your [Pipedream Data Store](https://pipedream.com/data-stores/).",
  version: "0.0.9",
  type: "action",
  props: {
    app,
    dataStore: {
      propDefinition: [
        app,
        "dataStore",
      ],
    },
    key: {
      propDefinition: [
        app,
        "key",
        ({ dataStore }) => ({
          dataStore,
        }),
      ],
      description: "Enter a key for the record you'd like to create or select an existing key to update.",
    },
    value: {
      propDefinition: [
        app,
        "value",
      ],
    },
  },
  async run({ $ }) {
    const {
      key,
      value,
    } = this;
    const exists = await this.dataStore.has(key);
    const parsedValue = this.app.parseValue(value);
    await this.dataStore.set(key, parsedValue);
    // eslint-disable-next-line multiline-ternary
    $.export("$summary", `Successfully ${exists ? "updated the record for" : "added a new record with the"} key, \`${key}\`.`);
    return {
      key,
      value: parsedValue,
    };
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Data Stores	`app`	`app`	This component uses the Data Stores app.
Data Store	`dataStore`	`data_store`	Select an existing Data Store or create a new one.
Key	`key`	`string`	Select a value from the drop down menu.
Value	`value`	`any`	Enter a string, object, or array.

Add or update a single record with Data Stores API on New Custom Event from UpKeep API

Pipedream makes it easy to connect APIs for Data Stores, UpKeep and 2,000+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,000+apps by most popular

1
-
24
of
2,000+
apps by most popular