List Products with ShipHero API on Task Checked from Process Street API

Pipedream makes it easy to connect APIs for ShipHero, Process Street and 2,900+ other apps remarkably fast.

Trigger workflow on

Task Checked from the Process Street API

Next, do this

List Products with the ShipHero API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

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

Select this integration
Configure the Task Checked trigger
1. Connect your Process Street account
2. Select a Workflow ID
3. Select a Workflow Run ID
Configure the List Products action
1. Connect your ShipHero account
2. Optional- Configure SKU
3. Optional- Configure Created From
4. Optional- Configure Created To
5. Optional- Configure Updated From
6. Optional- Configure Updated To
7. Optional- Configure Customer Account ID
8. Optional- Configure Has Kits
9. Optional- Configure Analyze
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#

Task Checked on Process Street

Description:Emit new event when a task is checked

Version:0.0.1

Key:process_street-task-checked

View on GitHub

Process Street Overview#

The Process Street API empowers you to automate and integrate your checklists and workflows with other apps to streamline business operations. With the API, you can create workflows, manage tasks, trigger actions based on checklist completion, and synchronize data across tools. This paves the way for endless possibilities in terms of project management, compliance tracking, onboarding processes, and routine audits, all managed within the familiar interface of Process Street but supercharged with Pipedream's connectivity.

Trigger Code#

import base from "../common/webhooks.mjs";
import constants from "../common/constants.mjs";

export default {
  ...base,
  key: "process_street-task-checked",
  name: "Task Checked",
  description: "Emit new event when a task is checked",
  type: "source",
  version: "0.0.1",
  props: {
    ...base.props,
    workflowId: {
      propDefinition: [
        base.props.processStreet,
        "workflowId",
      ],
      optional: false,
    },
    workflowRunId: {
      propDefinition: [
        base.props.processStreet,
        "workflowRunId",
        (c) => ({
          workflowId: c.workflowId,
        }),
      ],
    },
  },
  hooks: {
    ...base.hooks,
    async deploy() {
      console.log("Retrieving checked tasks...");
      const { tasks } = await this.processStreet.listTasks({
        paginate: true,
        workflowRunId: this.workflowRunId,
      });

      const filteredWorkflowRuns = tasks
        .filter((task) => task.status === constants.STATUSES.COMPLETED)
        .slice(constants.DEPLOY_LIMIT);

      for (const workflowRun of filteredWorkflowRuns) {
        this.emitEvent(workflowRun);
      }
    },
  },
  methods: {
    ...base.methods,
    getWebhookTypes() {
      return [
        constants.WEBHOOK_TYPES.TASK_CHECKED,
      ];
    },
    emitEvent(data) {
      this.$emit(data, {
        id: data.id,
        summary: `Checked task: ${data.name}`,
        ts: data.updatedDate,
      });
    },
  },
};

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
Process Street	`processStreet`	`app`	This component uses the Process Street app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
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.
Workflow ID	`workflowId`	`string`	Select a value from the drop down menu.
Workflow Run ID	`workflowRunId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

Each API key is associated with an individual organization in Process Street and can be managed from with the application

About Process Street#

Checklist, Workflow and SOP Software

Action#

List Products on ShipHero

Description:List products. [See the documentation](https://developer.shiphero.com/getting-started/)

Version:0.0.2

Key:shiphero-list-products

View on GitHub

ShipHero Overview#

The ShipHero API enables granular control over warehousing and order fulfillment processes, offering endpoints for managing inventory, orders, returns, and shipping. In Pipedream, you can leverage this API to automate routine tasks, sync data across multiple platforms, and trigger actions based on specific events. This can save time, reduce errors, and increase operational efficiency for e-commerce businesses.

Action Code#

import app from "../../shiphero.app.mjs";
import productQueries from "../../common/queries/product.mjs";

export default {
  key: "shiphero-list-products",
  name: "List Products",
  description: "List products. [See the documentation](https://developer.shiphero.com/getting-started/)",
  type: "action",
  version: "0.0.2",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: true,
  },
  props: {
    app,
    sku: {
      type: "string",
      label: "SKU",
      description: "The SKU of the product.",
      optional: true,
    },
    createdFrom: {
      type: "string",
      label: "Created From",
      description: "The date the product was created from. A DateTime field type that understand **ISO 8601** strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter\nEg.\n- `YYYY-mm-dd`\n- `YYYY-mm-dd HH:MM:SS`\n - `YYYY-mm-ddTHH:MM:SS`",
      optional: true,
    },
    createdTo: {
      type: "string",
      label: "Created To",
      description: "The date the product was created to. A DateTime field type that understand **ISO 8601** strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter\nEg.\n- `YYYY-mm-dd`\n- `YYYY-mm-dd HH:MM:SS`\n - `YYYY-mm-ddTHH:MM:SS`",
      optional: true,
    },
    updatedFrom: {
      type: "string",
      label: "Updated From",
      description: "The date the product was updated from. A DateTime field type that understand **ISO 8601** strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter\nEg.\n- `YYYY-mm-dd`\n- `YYYY-mm-dd HH:MM:SS`\n - `YYYY-mm-ddTHH:MM:SS`",
      optional: true,
    },
    updatedTo: {
      type: "string",
      label: "Updated To",
      description: "The date the product was updated to. A DateTime field type that understand **ISO 8601** strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter\nEg.\n- `YYYY-mm-dd`\n- `YYYY-mm-dd HH:MM:SS`\n - `YYYY-mm-ddTHH:MM:SS`",
      optional: true,
    },
    customerAccountId: {
      type: "string",
      label: "Customer Account ID",
      description: "The ID of the customer account.",
      optional: true,
    },
    hasKits: {
      type: "boolean",
      label: "Has Kits",
      description: "Whether the product has kits.",
      optional: true,
    },
    analyze: {
      type: "boolean",
      label: "Analyze",
      description: "Whether to analyze the product.",
      optional: true,
    },
  },
  methods: {
    listProducts(variables = {}) {
      return this.app.makeRequest({
        query: productQueries.listProducts,
        variables,
      });
    },
  },
  async run({ $: step }) {
    const {
      // eslint-disable-next-line no-unused-vars
      app,
      listProducts,
      ...variables
    } = this;

    const response = await listProducts(variables);

    step.export("$summary", `Successfully retrieved products with request ID \`${response.products.request_id}\`.`);

    return response;
  },
};

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
ShipHero	`app`	`app`	This component uses the ShipHero app.
SKU	`sku`	`string`	The SKU of the product.
Created From	`createdFrom`	`string`	The date the product was created from. A DateTime field type that understand ISO 8601 strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter Eg. `YYYY-mm-dd` `YYYY-mm-dd HH:MM:SS` `YYYY-mm-ddTHH:MM:SS`
Created To	`createdTo`	`string`	The date the product was created to. A DateTime field type that understand ISO 8601 strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter Eg. `YYYY-mm-dd` `YYYY-mm-dd HH:MM:SS` `YYYY-mm-ddTHH:MM:SS`
Updated From	`updatedFrom`	`string`	The date the product was updated from. A DateTime field type that understand ISO 8601 strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter Eg. `YYYY-mm-dd` `YYYY-mm-dd HH:MM:SS` `YYYY-mm-ddTHH:MM:SS`
Updated To	`updatedTo`	`string`	The date the product was updated to. A DateTime field type that understand ISO 8601 strings, besides datetime objects. It supports strings with and without times, as well as using `T` or space as delimiter Eg. `YYYY-mm-dd` `YYYY-mm-dd HH:MM:SS` `YYYY-mm-ddTHH:MM:SS`
Customer Account ID	`customerAccountId`	`string`	The ID of the customer account.
Has Kits	`hasKits`	`boolean`	Whether the product has kits.
Analyze	`analyze`	`boolean`	Whether to analyze the product.

Action Authentication#

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

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