Find OR Create Card with Planview Leankit API on New Task Archived Event from Kanban Tool API

Pipedream makes it easy to connect APIs for Planview Leankit, Kanban Tool and 2,700+ other apps remarkably fast.

Trigger workflow on

New Task Archived Event from the Kanban Tool API

Next, do this

Find OR Create Card with the Planview Leankit 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 Kanban Tool trigger and Planview Leankit action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Task Archived Event trigger
1. Connect your Kanban Tool account
2. Configure timer
3. Select a Board ID
Configure the Find OR Create Card action
1. Connect your Planview Leankit account
2. Select a Board Id
3. Configure Title
4. Optional- Select a Lane Id
5. Optional- Configure Custom Id
6. Optional- Select a Type Id
7. Optional- Select a Custom Icon Id
8. Optional- Select a Lane Class Types
9. Optional- Configure Since
10. Optional- Configure Deleted
11. Optional- Configure Only
12. Optional- Configure Omit
13. Optional- Select a Sort
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 Task Archived Event on Kanban Tool

Description:Emit new events when a task is archived on selected board. [See the docs](https://kanbantool.com/developer/api-v3#listing-boards-changelogs)

Version:0.0.1

Key:kanban_tool-task-archived

View on GitHub

Kanban Tool Overview#

The Kanban Tool API allows for the seamless integration and manipulation of Kanban boards, tasks, and workflows to optimize project management and team collaboration. By leveraging this API on Pipedream, you can automate task updates, synchronize boards with other data sources, and create custom notifications—thus enhancing productivity and maintaining momentum across projects.

Trigger Code#

import common from "../common/activity-based.mjs";

export default {
  ...common,
  key: "kanban_tool-task-archived",
  name: "New Task Archived Event",
  description: "Emit new events when a task is archived on selected board. [See the docs](https://kanbantool.com/developer/api-v3#listing-boards-changelogs)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    compareFn(item) {
      return item?.what == "archived";
    },
  },
};

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
Kanban Tool	`app`	`app`	This component uses the Kanban Tool app.
	`timer`	`$.interface.timer`
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Board ID	`boardId`	`integer`	Select a value from the drop down menu.

Trigger Authentication#

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

To get your API Token, sign in to your Kanban Tool account, and go to My Profile then API access.
If your Kanban Tool URL is https://123.kanbantool.com/, your domain is 123.

About Kanban Tool#

Kanban Tool is a visual management solution that helps companies visualize workflow, track project progress, and analyze and significantly improve business processes. Kanban Tool provides powerful online Kanban boards with seamless time tracking.

Action#

Find OR Create Card on Planview Leankit

Description:Find or create a new card. [See the docs here](https://success.planview.com/Planview_AgilePlace/AgilePlace_API/01_v2/card/list)

Version:0.0.1

Key:planview_leankit-find-or-create-card

View on GitHub

Planview Leankit Overview#

Planview LeanKit API empowers users to automate and integrate their Kanban workflow management. With this API, you can programmatically access boards, cards, and related data to sync with other systems, trigger actions based on board updates, and extract analytics for reporting purposes.

Action Code#

import planviewLeankit from "../../planview_leankit.app.mjs";

export default {
  key: "planview_leankit-find-or-create-card",
  name: "Find OR Create Card",
  version: "0.0.1",
  description: "Find or create a new card. [See the docs here](https://success.planview.com/Planview_AgilePlace/AgilePlace_API/01_v2/card/list)",
  type: "action",
  props: {
    planviewLeankit,
    boardId: {
      propDefinition: [
        planviewLeankit,
        "boardId",
      ],
    },
    title: {
      propDefinition: [
        planviewLeankit,
        "title",
      ],
    },
    laneId: {
      propDefinition: [
        planviewLeankit,
        "laneId",
        ({ boardId }) => ({
          boardId,
        }),
      ],
      optional: true,
    },
    customId: {
      propDefinition: [
        planviewLeankit,
        "customId",
      ],
      optional: true,
    },
    typeId: {
      propDefinition: [
        planviewLeankit,
        "typeId",
        ({ boardId }) => ({
          boardId,
        }),
      ],
      optional: true,
    },
    customIconId: {
      propDefinition: [
        planviewLeankit,
        "customIconId",
        ({ boardId }) => ({
          boardId,
        }),
      ],
      optional: true,
    },
    laneClassTypes: {
      propDefinition: [
        planviewLeankit,
        "laneClassTypes",
      ],
      optional: true,
    },
    since: {
      propDefinition: [
        planviewLeankit,
        "since",
      ],
      optional: true,
    },
    deleted: {
      propDefinition: [
        planviewLeankit,
        "deleted",
      ],
      optional: true,
    },
    only: {
      propDefinition: [
        planviewLeankit,
        "only",
      ],
      optional: true,
    },
    omit: {
      propDefinition: [
        planviewLeankit,
        "omit",
      ],
      optional: true,
    },
    sort: {
      propDefinition: [
        planviewLeankit,
        "sort",
      ],
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      planviewLeankit,
      title,
      laneClassTypes,
      since,
      deleted,
      only,
      omit,
      sort,
      ...params
    } = this;

    let response = await planviewLeankit.listCards({
      $,
      params: {
        search: title,
        since,
        deleted,
        only,
        omit,
        sort,
        laneClassTypes,
        ...params,
      },
    });
    let summary = `${response.cards.length} ${response.cards.length === 1
      ? "card was"
      : "cards were"} successfully fetched!`;

    if (!response.cards.length) {
      response = await planviewLeankit.createCard({
        $,
        data: {
          title,
          customId: title,
          ...params,
        },
      });
      summary = `Card with id ${response.id} was successfully created!`;
    }

    $.export("$summary", summary);
    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
Planview Leankit	`planviewLeankit`	`app`	This component uses the Planview Leankit app.
Board Id	`boardId`	`string`	Select a value from the drop down menu.
Title	`title`	`string`	The card title.
Lane Id	`laneId`	`string`	Select a value from the drop down menu.
Custom Id	`customId`	`string`	The card header.
Type Id	`typeId`	`string`	Select a value from the drop down menu.
Custom Icon Id	`customIconId`	`string`	Select a value from the drop down menu.
Lane Class Types	`laneClassTypes`	`string`	Select a value from the drop down menu:`backlogactivearchive`
Since	`since`	`string`	Only return cards updated after this ISO8601 date. String format: `YYYY-MM-DD`
Deleted	`deleted`	`boolean`	Return the card ids for deleted cards.
Only	`only`	`string`	Return only the fields specified in a csv list.
Omit	`omit`	`string`	Return all fields except the ones specified in a csv list.
Sort	`sort`	`string`	Select a value from the drop down menu:`activityranktitle`

Action Authentication#

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

Planview requires users to enter the email and password they use for their Planview account in order to access their API programmatically. For more information, refer to the Planview documentation

Pipedream recommends using a strong and unique password for your Planview account.

About Planview Leankit#

Planview LeanKit enables organizations and teams to visually track and manage the flow of work from strategy to delivery in enterprise Kanban boards. Share a consolidated view of work priority and status – whether in the same room or distributed across the globe.

More Ways to Connect Planview Leankit + Kanban Tool#

Other Popular Integrations#

Create a Parent/Child Connection with Planview Leankit API on New Task Archived Event from Kanban Tool API

Kanban Tool + Planview Leankit

Find OR Create Card with Planview Leankit API on New Task Archived Event from Kanban Tool API

Pipedream makes it easy to connect APIs for Planview Leankit, Kanban Tool and 2,700+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,700+apps by most popular

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