View as Markdown
Pipedrive icon

Pipedrive ACTION

Create Project

Creates a new project in Pipedrive. Use List Project Boards to obtain a valid Board ID and List Project Phases to obtain a valid Phase ID before running this action. Example: to open a project on the first board/phase, call with title="Q3 Website Redesign", status="open", boardId="1", phaseId="1" -> returns the created project 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 Project 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-project",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pipedrive: { authProvisionId: "apn_xxxxxxx" },
    title: "Title",
    description: "Description",
  },
})

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 Project inputs
Property Type Description
title Title string
The title of the project.
Required
description Description string
The description of the project.
Optional
status Status string
The status of the project. One of: open, completed, canceled, deleted.
Optional
boardId Board ID string
The ID of the board this project belongs to. Run List Project Boards first to obtain a valid board ID.
Optional
phaseId Phase ID string
The ID of the phase this project belongs to. Run List Project Phases (with the chosen board ID) first to obtain a valid phase ID.
Optional
ownerId Owner ID integer
The user ID of the project owner.
Optional Dynamic
startDate Start Date string
The start date of the project. Format: YYYY-MM-DD (e.g. 2026-07-31).
Optional
endDate End Date string
The end date of the project. Format: YYYY-MM-DD (e.g. 2026-08-31).
Optional
dealIds Deal IDs string[]
Array of deal IDs to associate with the project. Use List Deals to obtain a valid deal ID.
Optional
personIds Person IDs string[]
Array of person IDs to associate with the project. Use List Persons to obtain a valid person ID.
Optional
orgIds Organization IDs string[]
Array of organization IDs to associate with the project. Use List Organizations to obtain a valid organization ID.
Optional
labelIds Label IDs string[]
Array of numeric project-label IDs to associate with the project. Project labels are managed in Pipedrive under Settings → Labels — copy the numeric ID for each label you want to apply.
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-project
Version
0.0.2
App
Pipedrive
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes