Create Jira Version in project with Jira API on New Board Created Event from Kanban Tool API

Pipedream makes it easy to connect APIs for Jira, Kanban Tool and 2,800+ other apps remarkably fast.

Trigger workflow on

New Board Created Event from the Kanban Tool API

Next, do this

Create Jira Version in project with the Jira 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 Jira action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Board Created Event trigger
1. Connect your Kanban Tool account
2. Configure timer
Configure the Create Jira Version in project action
1. Connect your Jira account
2. Select a Cloud ID
3. Select a Project ID
4. Configure Version name
5. Optional- Configure Description
6. Optional- Configure Archived
7. Optional- Configure Released
8. Optional- Configure Start date
9. Optional- Configure Release date
10. Optional- Configure Move unfixed issues to
11. Optional- Configure Expand
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 Board Created Event on Kanban Tool

Description:Emit new events when a new board is created or given access for a new board. [See the docs](https://kanbantool.com/developer/api-v3#listing-boards)

Version:0.0.1

Key:kanban_tool-new-board

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/common.mjs";

export default {
  ...common,
  key: "kanban_tool-new-board",
  name: "New Board Created Event",
  description: "Emit new events when a new board is created or given access for a new board. [See the docs](https://kanbantool.com/developer/api-v3#listing-boards)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    getResourceFnConfig() {
      return {
        resourceFn: this.app.getUser,
        resourceKey: "boards",
        pagingCfg: {
          noPaging: true,
        },
      };
    },
    async getItem(item) {
      return this.app.getBoard({
        boardId: item.id,
      });
    },
    getComparable(item) {
      return new Date(item?.created_at).getTime();
    },
    getMeta(item) {
      return {
        id: item?.id,
        summary: `New board created: ${item.name}(ID: ${item.id})`,
        ts: new Date(item?.created_at).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
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.

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#

Create Jira Version in project on Jira

Description:Creates a project version., [See the docs](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-versions/#api-rest-api-3-version-post)

Version:0.1.11

Key:jira-create-version

View on GitHub

Jira Overview#

The Jira API opens up a world of possibilities for automating project management tasks, syncing with other tools, and enhancing data visibility. With Pipedream's integration, you can streamline issue tracking by automatically creating, updating, and searching for issues in Jira, as well as managing projects, sprints, users, and more. This integration not only saves time but also ensures real-time data flow across various platforms, keeping teams in sync and projects on track.

Action Code#

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

export default {
  key: "jira-create-version",
  name: "Create Jira Version in project",
  description: "Creates a project version., [See the docs](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-versions/#api-rest-api-3-version-post)",
  version: "0.1.11",
  type: "action",
  props: {
    jira,
    cloudId: {
      propDefinition: [
        jira,
        "cloudId",
      ],
    },
    projectID: {
      propDefinition: [
        jira,
        "projectID",
        (c) => ({
          cloudId: c.cloudId,
        }),
      ],
    },
    name: {
      type: "string",
      label: "Version name",
      description: "The unique name of the version. Required when creating a version. The maximum length is 255 characters.",
    },
    description: {
      type: "string",
      label: "Description",
      description: "The description of the version.",
      optional: true,
    },
    archived: {
      type: "boolean",
      label: "Archived",
      description: "Indicates that the version is archived.",
      optional: true,
    },
    released: {
      type: "boolean",
      label: "Released",
      description: "Indicates that the version is released. If the version is released a request to release again is ignored. Not applicable when creating a version.",
      optional: true,
    },
    startDate: {
      type: "string",
      label: "Start date",
      description: "The start date of the version. Expressed in ISO 8601 format (yyyy-mm-dd).",
      optional: true,
    },
    releaseDate: {
      type: "string",
      label: "Release date",
      description: "The release date of the version. Expressed in ISO 8601 format (yyyy-mm-dd).",
      optional: true,
    },
    moveUnfixedIssuesTo: {
      type: "string",
      label: "Move unfixed issues to",
      description: "The URL of the self link to the version to which all unfixed issues are moved when a version is released. Not applicable when creating a version. Optional when updating a version.",
      optional: true,
    },
    expand: {
      propDefinition: [
        jira,
        "expand",
      ],
      description: "Use expand to include additional information about version in the response. This parameter accepts a comma-separated list. Expand options include:\n`operations` Returns the list of operations available for this version.\n`issuesstatus` Returns the count of issues in this version for each of the status categories `to do`, `in progress`, `done`, and `unmapped`.",
    },
  },
  async run({ $ }) {
    const response = await this.jira.createVersion({
      $,
      cloudId: this.cloudId,
      data: {
        projectId: this.projectID,
        name: this.name,
        description: this.description,
        archived: this.archived,
        released: this.released,
        startDate: this.startDate,
        releaseDate: this.releaseDate,
        moveUnfixedIssuesTo: this.moveUnfixedIssuesTo,
        expand: this.expand,
      },
    });
    $.export("$summary", `Version has been created successfuly. (ID:${response.id}, NAME:${response.name})`);
    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
Jira	`jira`	`app`	This component uses the Jira app.
Cloud ID	`cloudId`	`string`	Select a value from the drop down menu.
Project ID	`projectID`	`string`	Select a value from the drop down menu.
Version name	`name`	`string`	The unique name of the version. Required when creating a version. The maximum length is 255 characters.
Description	`description`	`string`	The description of the version.
Archived	`archived`	`boolean`	Indicates that the version is archived.
Released	`released`	`boolean`	Indicates that the version is released. If the version is released a request to release again is ignored. Not applicable when creating a version.
Start date	`startDate`	`string`	The start date of the version. Expressed in ISO 8601 format (yyyy-mm-dd).
Release date	`releaseDate`	`string`	The release date of the version. Expressed in ISO 8601 format (yyyy-mm-dd).
Move unfixed issues to	`moveUnfixedIssuesTo`	`string`	The URL of the self link to the version to which all unfixed issues are moved when a version is released. Not applicable when creating a version. Optional when updating a version.
Expand	`expand`	`string`	Use expand to include additional information about version in the response. This parameter accepts a comma-separated list. Expand options include: `operations` Returns the list of operations available for this version. `issuesstatus` Returns the count of issues in this version for each of the status categories `to do`, `in progress`, `done`, and `unmapped`.

Action Authentication#

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

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

read:jira-workmanage:jira-projectread:jira-userwrite:jira-workmanage:jira-data-providerread:meoffline_accessread:issue-details:jiraread:board-scope:jira-softwareread:webhook:jirawrite:webhook:jiraread:field:jiraread:project:jiradelete:webhook:jirawrite:board-scope:jira-softwareread:board-scope.admin:jira-softwareread:sprint:jira-softwarewrite:sprint:jira-softwareread:field.option:jirawrite:field.option:jiraread:custom-field-contextual-configuration:jira write:custom-field-contextual-configuration:jiramanage:jira-configurationread:jql:jira

Create Jira Version in project with Jira API on New Board Created Event from Kanban Tool API

Pipedream makes it easy to connect APIs for Jira, Kanban Tool and 2,800+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,800+apps by most popular

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