# Create New Task — Kanbanize

> Create New Task. See the docs here

- Key: `kanbanize-create-new-task`
- Type: Action (Write)
- Version: 0.0.2
- App: Kanbanize (`kanbanize`) — https://pipedream.com/apps/kanbanize.md
- This page (HTML): https://pipedream.com/apps/kanbanize/actions/create-new-task
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/kanbanize/actions/create-new-task/create-new-task.mjs

## Description

Create New Task. [See the docs here](https://kanbanize.com/api)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `boardId` | `string` | Yes | The ID of the board whose structure you want to get. You can see the board ID on the dashboard screen, in the upper right corner of each board. Options are loaded from the connected account. |
| `title` | `string` | No | Title of the task. |
| `description` | `string` | No | Description of the task. |
| `type` | `string` | No | The type of the task. Options are loaded from the connected account. |
| `assignee` | `string` | No | Username of the assignee. Options are loaded from the connected account. |
| `column` | `string` | No | The name of the column to create the task into (default is Backlog). Options are loaded from the connected account. |
| `lane` | `string` | No | The name of the swimlane to put the newly created task into. If omitted, the task will be placed in the first swimlane. Options are loaded from the connected account. |
| `position` | `integer` | No | The position of the task in the new column/swimlane (zero-based). If omitted, the task will be placed at the bottom of the column. |
| `template` | `string` | No | The name of the template you want to apply. If you specify any property as part of the request, the one specified in the template will be overwritten. Options are loaded from the connected account. |
| `exceedingReason` | `string` | No | If you can exceed a limit with a reason, supply it with this parameter. Applicable only if column, lane and/or position are supplied. |
| `priority` | `string` | No | Priority of the task. |
| `size` | `integer` | No | Size of the task. |
| `extLink` | `string` | No | A external link in the following format: https://domain.com/resource |
| `deadline` | `string` | No | Deadline in the format: yyyy-mm-dd (e.g. 2011-12-13). |
| `color` | `string` | No | Any color code (e.g. #34A97B). |
| `tags` | `string[]` | No | List of tags. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "kanbanize",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "kanbanize-create-new-task",
  arguments: {
    boardId: "Board Id",
    title: "Title",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "kanbanize-create-new-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    kanbanize: { authProvisionId: "apn_xxxxxxx" },
    boardId: "Board Id",
    title: "Title",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "kanbanize-create-new-task",
    "configured_props": {
      "kanbanize": { "authProvisionId": "apn_xxxxxxx" },
      "boardId": "Board Id",
      "title": "Title"
    }
  }'
```

---

- App: https://pipedream.com/apps/kanbanize.md · All apps: https://pipedream.com/apps