View as Markdown
Pipedrive icon

Pipedrive ACTION

Create Task

Creates a new task under a project (BETA). Run List Projects first to obtain a valid project ID. Use List User ID Options for the assignee ID. Example: to add a task to a project, call with title="Draft kickoff agenda" and projectId="7" -> returns the created task with its numeric id. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Pipedrive account once, then configure and run Create Task from your backend or agent.

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: "pipedrive-create-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pipedrive: { authProvisionId: "apn_xxxxxxx" },
    title: "Title",
    projectId: "Project ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Task inputs
Property Type Description
title Title string
The title of the task.
Required
projectId Project ID string
The ID of the project this task belongs to. Run List Projects first to obtain a valid project ID.
Required
parentTaskId Parent Task ID string
The ID of the parent task, if this is a subtask. Use List Tasks to obtain a valid task ID.
Optional
description Description string
The description of the task.
Optional
done Done integer
Whether the task is done. Integer: 0 (not done) or 1 (done).
Optional
milestone Milestone integer
Whether the task is a milestone. Integer: 0 (no) or 1 (yes).
Optional
dueDate Due Date string
The due date of the task. Format: YYYY-MM-DD (e.g. 2026-07-31).
Optional
startDate Start Date string
The start date of the task. Format: YYYY-MM-DD.
Optional
assigneeId Assignee ID integer
The user ID of the task assignee.
Optional Dynamic
priority Priority integer
The priority of the task (non-negative integer).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
pipedrive-create-task
Version
0.0.2
App
Pipedrive
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes