Pipedrive

Learn how to use Pipedrive with Composio

Overview

Enum

PIPEDRIVE

Description

Pipedrive is a sales management tool built around pipeline visualization, lead tracking, activity reminders, and automation to keep deals progressing

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to contacts:full leads:full mail:full activities:full products:full projects:full
COMPANYDOMAIN
stringRequired
token
stringRequired
COMPANYDOMAIN
stringRequired

Actions

Returns the details of a specific project phase.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates an activity type.

Action Parameters

id
integerRequired
name
string
icon_key
string
color
string
order_nr
integer

Action Response

data
object
successful
boolean
error

Lists mail messages associated with a deal.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new installment subscription.

Action Parameters

deal_id
integerRequired
currency
stringRequired
payments
arrayRequired
update_deal_value
boolean

Action Response

data
object
successful
boolean
error

Deletes a participant from a deal.

Action Parameters

id
integerRequired
deal_participant_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about teams within the company.

Action Parameters

order_by
stringDefaults to id
skip_users
integer

Action Response

data
object
successful
boolean
error

Lists the users permitted to access a deal.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about a specific team.

Action Parameters

id
integerRequired
skip_users
integer

Action Response

data
object
successful
boolean
error

Deletes a person’s picture.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

The api returns sorted leads by creation time, supporting pagination via limit and start. custom field values are included if set, mimicking the deals endpoint structure; unset fields are omitted. leads share custom fields with deals.

Action Parameters

limit
integer
start
integer
archived_status
string
owner_id
integer
person_id
integer
organization_id
integer
filter_id
integer
sort
string

Action Response

data
object
successful
boolean
error

The endpoint retrieves all non-deleted project templates with cursor-based pagination. refer to the provided documentation link for more details on pagination.

Action Parameters

cursor
string
limit
integer

Action Response

data
object
successful
boolean
error

Marks a product field as deleted. for more information, see the tutorial for deleting a custom field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

This endpoint provides cursor-paginated updates on deal participants. for pagination details, see the pipedrive documentation.

Action Parameters

id
integerRequired
limit
integer
cursor
string

Action Response

data
object
successful
boolean
error

Deletes an existing conversation. to use the endpoint, you need to have messengers integration oauth scope enabled and the messaging manifest ready for the messaging app extension.

Action Parameters

channel__id
stringRequired
conversation__id
stringRequired

Action Response

data
object
successful
boolean
error

Api returns specific lead details with custom field values in the deals format. unset custom fields are omitted. leads share custom fields with deals, not having a unique set.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Returns all projects boards that are not deleted.

Action Parameters

Action Response

data
object
successful
boolean
error

Lists updates about a deal.

Action Parameters

id
integerRequired
start
integer
limit
integer
all_changes
string
items
string

Action Response

data
object
successful
boolean
error

Adds a new organization field. for more information, see the tutorial for adding a new custom field.

Action Parameters

Action Response

data
object
successful
boolean
error

Updates the properties of a file.

Action Parameters

id
integerRequired
description
string
name
string

Action Response

data
object
successful
boolean
error

Returns data about all connections for the authorized user.

Action Parameters

Action Response

data
object
successful
boolean
error

Access tokens expire after the time specified in expires in. to continue accessing the api, use the refresh token to obtain a new access token.

Action Parameters

grant_type
stringDefaults to refresh_token
refresh_token
string

Action Response

data
object
successful
boolean
error

Fetches specific deal details, including exclusive fields like deal age and pipeline stage duration. custom fields show up as hashes, which can be matched using the ‘key’ from dealfields. see the deal details tutorial for more.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists persons associated with an organization.if a company uses the campaigns product, then this endpoint will also return the data.marketing status field.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new task.

Action Parameters

Action Response

data
object
successful
boolean
error

Deletes a specific note.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Deletes a call log. if there is an audio recording attached to it, it will also be deleted. the related activity will not be removed by this request. if you want to remove the related activities, please use the endpoint which is specific for activities.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Marks an installment or a recurring subscription as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all pipelines.

Action Parameters

Action Response

data
object
successful
boolean
error

The endpoint lists every person linked to a deal, including primary contacts and participants, and provides a data.marketing status field for users of the campaigns product.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns the visibility settings of a specific role.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates an installment subscription.

Action Parameters

id
integerRequired
payments
arrayRequired
update_deal_value
boolean

Action Response

data
object
successful
boolean
error

Returns all payments of an installment or recurring subscription.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates a deal field. for more information, see the tutorial for updating custom fields’ values.

Action Parameters

id
integerRequired
name
string
options
array
add_visible_flag
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Returns data about a specific product field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks a product as deleted. after 30 days, the product will be permanently deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Finds users by their name.

Action Parameters

term
stringRequired
search_by_email
integer

Action Response

data
object
successful
boolean
error

Lists files associated with a person.

Action Parameters

id
integerRequired
start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Authorize a user by redirecting them to the pipedrive oauth authorization page and request their permissions to act on their behalf. this step is necessary to implement only when you allow app installation outside of the marketplace.

Action Parameters

client_id
stringRequired
redirect_uri
stringRequired
state
string

Action Response

data
object
successful
boolean
error

Endpoint searches leads by title, notes, custom fields, with options to filter by person and organization ids, and is a more specific use of the /v1/itemsearch with limited oauth scope.

Action Parameters

term
stringRequired
fields
string
exact_match
boolean
person_id
integer
organization_id
integer
include_fields
string
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new comment to a note.

Action Parameters

id
integerRequired
content
stringRequired

Action Response

data
object
successful
boolean
error

Adds an audio recording to the call log. that audio can be played by those who have access to the call log object.

Action Parameters

id
stringRequired
file
object

Action Response

data
object
successful
boolean
error

Updates one or more properties of a lead label. only properties included in the request will be updated.

Action Parameters

id
stringRequired
name
string
color
string

Action Response

data
object
successful
boolean
error

Searches all products by name, code and/or custom fields. this endpoint is a wrapper of /v1/itemsearch with a narrower oauth scope.

Action Parameters

term
stringRequired
fields
string
exact_match
boolean
include_fields
string
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Lists the users permitted to access a lead.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Deletes the specified webhook.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all teams which have the specified user as a member.

Action Parameters

id
integerRequired
order_by
stringDefaults to id
skip_users
integer

Action Response

data
object
successful
boolean
error

Updating lead properties modifies only specified fields; use null to unset. custom field data matches deals. unset fields are omitted. leads share deals’ custom fields. for examples, refer to the tutorial.

Action Parameters

id
stringRequired
title
string
owner_id
integer
label_ids
array
person_id
integer
organization_id
integer
is_archived
boolean
value__amount
integer
value__currency
string
expected_close_date
string
was_seen
boolean

Action Response

data
object
successful
boolean
error

Updates the parent role and/or the name of a specific role.

Action Parameters

id
integerRequired
parent_role_id
integer
name
string

Action Response

data
object
successful
boolean
error

Merges a deal with another deal. for more information, see the tutorial for merging two deals.

Action Parameters

id
integerRequired
merge_with_id
integerRequired

Action Response

data
object
successful
boolean
error

List users permitted to access an organization.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all the webhooks of a company.

Action Parameters

Action Response

data
object
successful
boolean
error

Lists role assignments for a user.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns activities linked to a specific project.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all comments associated with a note.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Searches all organizations by name, address, notes and/or custom fields. this endpoint is a wrapper of /v1/itemsearch with a narrower oauth scope.

Action Parameters

term
stringRequired
fields
string
exact_match
boolean
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Marks a field as deleted. for more information, see the tutorial for deleting a custom field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns details of a specific call log.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Add a new deal to pipedrive with any custom fields, which vary by account and are identified by long hash keys. check dealfields for existing custom fields. for details, visit the tutorial on adding a deal.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks a pipeline as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks a deal as deleted. after 30 days, the deal will be permanently deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates a project.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists users permitted to access a product.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Merges an organization with another organization. for more information, see the tutorial for merging two organizations.

Action Parameters

id
integerRequired
merge_with_id
integerRequired

Action Response

data
object
successful
boolean
error

This beta api endpoint lists all organizations with cursor pagination. only global admins have access; others get a 403 error. see docs for pagination and global permissions.

Action Parameters

cursor
string
limit
integer
since
string
until
string
owner_id
integer
first_char
string

Action Response

data
object
successful
boolean
error

Returns the details of a comment.

Action Parameters

id
integerRequired
commentId
stringRequired

Action Response

data
object
successful
boolean
error

Updates a task.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

New activity added. response includes more activities scheduled in context to show if more are planned with the same entity. see tutorial on adding activities here.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks a field as deleted. for more information, see the tutorial for deleting a custom field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Deletes a follower from a deal.

Action Parameters

id
integerRequired
follower_id
integerRequired

Action Response

data
object
successful
boolean
error

Updates the properties of a pipeline.

Action Parameters

id
integerRequired
name
string
order_nr
integer

Action Response

data
object
successful
boolean
error

This endpoint returns all deals with cursor pagination (in beta). only global admins can access it; others get a 403 error. more info on pagination and permissions is available online.

Action Parameters

cursor
string
limit
integer
since
string
until
string
user_id
integer
stage_id
integer
status
string

Action Response

data
object
successful
boolean
error

Returns data about all permission sets.

Action Parameters

app
string

Action Response

data
object
successful
boolean
error

Lists activities associated with a person.

Action Parameters

id
integerRequired
start
integer
limit
integer
done
integer
exclude
string

Action Response

data
object
successful
boolean
error

Deletes a follower from a person.

Action Parameters

id
integerRequired
follower_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns details of all lead labels. this endpoint does not support pagination and all labels are always returned.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks a project as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates a recurring subscription.

Action Parameters

id
integerRequired
description
string
cycle_amount
integer
payments
array
update_deal_value
boolean
effective_date
stringRequired

Action Response

data
object
successful
boolean
error

Marks multiple deals as deleted. after 30 days, the deals will be permanently deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Returns data about all stages.

Action Parameters

pipeline_id
integer
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns data about a specific user within the company.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds or updates the visibility setting for a role.

Action Parameters

id
integerRequired
setting_key
stringRequired
value
integerRequired

Action Response

data
object
successful
boolean
error

Upload and link files to deals, people, organizations, activities, products, or leads in pipedrive. see the “adding a file” tutorial for details.

Action Parameters

file
object
deal_id
integer
person_id
integer
org_id
integer
product_id
integer
activity_id
integer
lead_id
object

Action Response

data
object
successful
boolean
error

Returns data about a specific filter. note that this also returns the condition lines of the filter.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists the followers of an organization.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns a specific mail thread.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns the details of a specific activity.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all organizations.

Action Parameters

user_id
integer
filter_id
integer
first_char
string
start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Returns a list of visible or hidden pipeline ids by role. see the “visibility groups article” for details on pipeline visibility.

Action Parameters

id
integerRequired
visible
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Creates a lead label.

Action Parameters

name
stringRequired
color
stringRequired

Action Response

data
object
successful
boolean
error

This endpoint searches for individuals by various identifiers and is a specific use case of /v1/itemsearch with limited oauth scope, allowing results filtering by organization id.

Action Parameters

term
stringRequired
fields
string
exact_match
boolean
organization_id
integer
include_fields
string
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds users to an existing team.

Action Parameters

id
integerRequired
users
arrayRequired

Action Response

data
object
successful
boolean
error

Lists mail messages associated with an organization.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Updates an organization field. for more information, see the tutorial for updating custom fields’ values.

Action Parameters

id
integerRequired
name
string
options
array
add_visible_flag
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Returns details about a specific note.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all tasks. this is a cursor-paginated endpoint. for more information, please refer to our documentation on pagination.

Action Parameters

cursor
string
limit
integer
assignee_id
integer
project_id
integer
parent_task_id
integer
done
integer

Action Response

data
object
successful
boolean
error

Returns all users assigned to a role.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Query goal data by appending {searchfield}`=`{searchvalue} to the url with dot-notation fields and values. include is active to filter by goal status and specify both period.start and period.end for time-based searches.

Action Parameters

type__name
string
title
string
is_active
booleanDefaults to True
assignee__id
integer
assignee__type
string
expected__outcome__target
integer
expected__outcome__tracking__metric
string
expected__outcome__currency__id
integer
type__params__pipeline__id
array
type__params__stage__id
integer
type__params__activity__type__id
array
period__start
string
period__end
string

Action Response

data
object
successful
boolean
error

Returns data about all users within the company.

Action Parameters

Action Response

data
object
successful
boolean
error

Set up a new pipedrive organization using custom fields with unique key hashes. retrieve organizationfields for configuration. check the linked tutorial for guidance.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns statistics for deals movements for the given time period.

Action Parameters

id
integerRequired
start_date
stringRequired
end_date
stringRequired
user_id
integer

Action Response

data
object
successful
boolean
error

Adds a follower to an organization.

Action Parameters

id
integerRequired
user_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns information about items in a project plan. items consists of tasks and activities and are linked to specific project phase and group.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all active groups under a specific project.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a follower to a product.

Action Parameters

id
integerRequired
user_id
integerRequired

Action Response

data
object
successful
boolean
error

Updates the properties of a stage.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks multiple persons as deleted. after 30 days, the persons will be permanently deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Updates an existing goal.

Action Parameters

id
stringRequired
title
string
interval
string

Action Response

data
object
successful
boolean
error

Deletes a follower from an organization. you can retrieve the follower id from the list followers of an organization endpoint.

Action Parameters

id
integerRequired
follower_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all person fields.if a company uses the campaigns product, then this endpoint will also return the data.marketing status field.

Action Parameters

start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns data about all products.

Action Parameters

user_id
integer
filter_id
integer
ids
array
first_char
string
get_summary
boolean
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns data about a specific file.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks a person as deleted. after 30 days, the person will be permanently deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks multiple organizations as deleted. after 30 days, the organizations will be permanently deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Adds a follower to a person.

Action Parameters

id
integerRequired
user_id
integerRequired

Action Response

data
object
successful
boolean
error

List users permitted to access a person.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all deals. for more information, see the tutorial for getting all deals.

Action Parameters

user_id
integer
filter_id
integer
stage_id
integer
status
stringDefaults to all_not_deleted
start
integer
limit
integer
sort
string
owned_by_you
integer

Action Response

data
object
successful
boolean
error

Deletes a product attachment from a deal, using the product attachment id.

Action Parameters

id
integerRequired
product_attachment_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all notes.

Action Parameters

user_id
integer
lead_id
string
deal_id
integer
person_id
integer
org_id
integer
start
integer
limit
integer
sort
string
start_date
string
end_date
string
pinned_to_lead_flag
integer
pinned_to_deal_flag
integer
pinned_to_organization_flag
integer
pinned_to_person_flag
integer

Action Response

data
object
successful
boolean
error

Deletes a follower from a product.

Action Parameters

id
integerRequired
follower_id
integerRequired

Action Response

data
object
successful
boolean
error

Updates a task phase or group in a project.

Action Parameters

id
integerRequired
taskId
integerRequired
phase_id
integer
group_id
integer

Action Response

data
object
successful
boolean
error

Returns a summary of all the deals.

Action Parameters

status
string
filter_id
integer
user_id
integer
stage_id
integer

Action Response

data
object
successful
boolean
error

Updates the details of the product that has been attached to a deal.

Action Parameters

id
integerRequired
product_attachment_id
integerRequired
product_id
integer
item_price
integer
quantity
integer
discount
integer
discount_type
stringDefaults to percentage
duration
integerDefaults to 1
product_variation_id
integer
comments
string
tax
integer
tax_method
string
enabled_flag
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Returns data about a specific organization field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates an activity phase or group in a project.

Action Parameters

id
integerRequired
activityId
integerRequired
phase_id
integer
group_id
integer

Action Response

data
object
successful
boolean
error

Marks an organization as deleted. after 30 days, the organization will be permanently deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a participant to a deal.

Action Parameters

id
integerRequired
person_id
integerRequired

Action Response

data
object
successful
boolean
error

This beta endpoint returns all persons, using cursor pagination. only global admins have access; others get a 403 error. info on pagination and permissions is in the linked docs.

Action Parameters

cursor
string
limit
integer
since
string
until
string
owner_id
integer
first_char
string

Action Response

data
object
successful
boolean
error

Adds a new product field. for more information, see the tutorial for adding a new custom field.

Action Parameters

name
stringRequired
options
array
field_type
stringRequired

Action Response

data
object
successful
boolean
error

This service allows adding a photo to a person’s profile, replacing any existing one. images must be square with a minimum size of 128 pixels and in gif, jpg, or png formats. they will be resized to 128 and 512 pixels.

Action Parameters

id
integerRequired
file
object
crop_x
integer
crop_y
integer
crop_width
integer
crop_height
integer

Action Response

data
object
successful
boolean
error

Lists files associated with an organization.

Action Parameters

id
integerRequired
start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Gets the progress of a goal for the specified period.

Action Parameters

id
stringRequired
period__start
stringRequired
period__end
stringRequired

Action Response

data
object
successful
boolean
error

Returns all call logs assigned to a particular user.

Action Parameters

start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new activity type.

Action Parameters

name
stringRequired
icon_key
stringRequired
color
string

Action Response

data
object
successful
boolean
error

This beta cursor-paginated endpoint returns all activities, accessible only to global admins, not regular users who get a 403 error. refer to pipedrive’s documentation for pagination and global permissions.

Action Parameters

cursor
string
limit
integer
since
string
until
string
user_id
integer
done
boolean
type
string

Action Response

data
object
successful
boolean
error

Returns the details of a specific project board.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates a product field. for more information, see the tutorial for updating custom fields’ values.

Action Parameters

id
integerRequired
name
string
options
array

Action Response

data
object
successful
boolean
error

Deletes a specific lead label.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Lists activities associated with a deal.

Action Parameters

id
integerRequired
start
integer
limit
integer
done
integer
exclude
string

Action Response

data
object
successful
boolean
error

Lists products attached to a deal.

Action Parameters

id
integerRequired
start
integer
limit
integer
include_product_data
integer

Action Response

data
object
successful
boolean
error

Updates product data.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all the roles within the company.

Action Parameters

start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new person field. for more information, see the tutorial for adding a new custom field.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns the details of a specific role.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates the properties of a deal. for more information, see the tutorial for updating a deal.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a new project. note that you can supply additional custom fields along with the request that are not described here. these custom fields are different for each pipedrive account and can be recognized by long hashes as keys.

Action Parameters

Action Response

data
object
successful
boolean
error

Lists the followers of a specific user.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists files associated with a deal.

Action Parameters

id
integerRequired
start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Returns all activities assigned to a particular user.

Action Parameters

user_id
integer
filter_id
integer
type
string
limit
integer
start
integer
start_date
string
end_date
string
done
integer

Action Response

data
object
successful
boolean
error

Returns data about all product fields.

Action Parameters

start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Provides detailed information about an organization, including additional fields not shown when listing all organizations, and maps custom fields as long hashes to the ‘key’ value in organizationfields.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Initializes a file download.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates a note.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about a specific pipeline. also returns the summary of the deals in this pipeline across its stages.

Action Parameters

id
integerRequired
totals_convert_currency
string

Action Response

data
object
successful
boolean
error

Deletes users from an existing team.

Action Parameters

id
integerRequired
users
arrayRequired

Action Response

data
object
successful
boolean
error

Returns data about all note fields.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns the details of a specific project template.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns opened and won deals in time-based groups according to a specified dealfield, with examples of deals grouped by month over a 3-month period starting january 2012.

Action Parameters

start_date
stringRequired
interval
stringRequired
amount
integerRequired
field_key
stringRequired
user_id
integer
pipeline_id
integer
filter_id
integer
exclude_deals
integer
totals_convert_currency
string

Action Response

data
object
successful
boolean
error

Returns tasks linked to a specific project.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a new call log.

Action Parameters

user_id
integer
activity_id
integer
subject
string
duration
string
outcome
stringRequired
from_phone_number
string
to_phone_number
stringRequired
start_time
stringRequired
end_time
stringRequired
person_id
integer
org_id
integer
deal_id
integer
lead_id
string
note
string

Action Response

data
object
successful
boolean
error

Adds a follower to a deal.

Action Parameters

id
integerRequired
user_id
integerRequired

Action Response

data
object
successful
boolean
error

Lists the participants associated with a deal.if a company uses the campaigns product, then this endpoint will also return the data.marketing status field.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

New messaging channel added; registration limited to admins. utilizes getconversations endpoint for data retrieval. requires messengers integration oauth scope and a prepared messaging app extension manifest.

Action Parameters

name
stringRequired
provider_channel_id
stringRequired
avatar_url
string
template_support
boolean
provider_type
stringDefaults to other

Action Response

data
object
successful
boolean
error

Lists products associated with a person.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns all persons.

Action Parameters

user_id
integer
filter_id
integer
first_char
string
start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Returns data about a specific product.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates and returns an organization relationship.

Action Parameters

id
integerRequired
org_id
integer
type
string
rel_owner_org_id
integer
rel_linked_org_id
integer

Action Response

data
object
successful
boolean
error

Cancels a recurring subscription.

Action Parameters

id
integerRequired
end_date
string

Action Response

data
object
successful
boolean
error

Marks a stage as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists the followers of a person.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Creates and returns details of a new webhook. trigger events combine event action and event object, like *.* for all events or added.deal, deleted.persons for specific actions. more info in the webhooks guide.

Action Parameters

version
stringDefaults to 1.0
subscription_url
stringRequired
event_action
stringRequired
event_object
stringRequired
user_id
integer
http_auth_user
string
http_auth_password
string

Action Response

data
object
successful
boolean
error

Updates the properties of an organization.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists deals in a specific pipeline across all its stages.

Action Parameters

id
integerRequired
filter_id
integer
user_id
integer
everyone
integer
stage_id
integer
start
integer
limit
integer
get_summary
integer
totals_convert_currency
string

Action Response

data
object
successful
boolean
error

Returns data about a specific stage.

Action Parameters

id
integerRequired
everyone
integer

Action Response

data
object
successful
boolean
error

Deletes a specific lead.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Returns a list of all user ids within a team.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a new recurring subscription.

Action Parameters

description
string
deal_id
integerRequired
currency
stringRequired
cadence_type
stringRequired
cycles_count
integer
cycle_amount
integerRequired
start_date
stringRequired
infinite
boolean
payments
array
update_deal_value
boolean

Action Response

data
object
successful
boolean
error

Lists the followers of a product.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new user to the company, returns the id upon success.

Action Parameters

email
stringRequired
access
arrayDefaults to [{'app': 'sales'}]
active_flag
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Updates pipeline visibility settings for different roles. for details, see the pipedrive visibility groups article.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all activity fields.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns details of an installment or a recurring subscription by the deal id.

Action Parameters

dealId
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all deal fields.

Action Parameters

start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Lists updates about an organization.

Action Parameters

id
integerRequired
start
integer
limit
integer
all_changes
string
items
string

Action Response

data
object
successful
boolean
error

Gets all of the relationships for a supplied organization id.

Action Parameters

org_id
integerRequired

Action Response

data
object
successful
boolean
error

Pipedrive api lets you add leads linked to people or organizations and tags them with ‘api’ source. custom fields from deals apply to leads and appear in responses if set. details are in the tutorials for adding and updating leads.

Action Parameters

title
stringRequired
owner_id
integer
label_ids
array
person_id
integer
organization_id
integer
value__amount
integer
value__currency
string
expected_close_date
string
was_seen
boolean

Action Response

data
object
successful
boolean
error

Adds a new role.

Action Parameters

name
stringRequired
parent_role_id
integer

Action Response

data
object
successful
boolean
error

Archives a project.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all stage-to-stage conversion and pipeline-to-close rates for the given time period.

Action Parameters

id
integerRequired
start_date
stringRequired
end_date
stringRequired
user_id
integer

Action Response

data
object
successful
boolean
error

Performs a search from the values of a specific field. results can either be the distinct values of the field (useful for searching autocomplete field values), or the ids of actual items (deals, leads, persons, organizations or products).

Action Parameters

term
stringRequired
field_type
stringRequired
exact_match
boolean
field_key
stringRequired
return_item_ids
boolean
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Lists files associated with a product.

Action Parameters

id
integerRequired
start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Updates a person field. for more information, see the tutorial for updating custom fields’ values.

Action Parameters

id
integerRequired
name
string
options
array
add_visible_flag
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Marks an activity as deleted. after 30 days, the activity will be permanently deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Assigns a user to a role.

Action Parameters

id
integerRequired
user_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns the details of a specific task.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Removes the assigned user from a role and adds to the default role.

Action Parameters

id
integerRequired
user_id
integerRequired

Action Response

data
object
successful
boolean
error

Creates and returns an organization relationship.

Action Parameters

org_id
integer
type
stringRequired
rel_owner_org_id
integerRequired
rel_linked_org_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all files.

Action Parameters

start
integer
limit
integer
sort
string

Action Response

data
object
successful
boolean
error

Returns data about a specific permission set.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Marks a goal as deleted.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Returns all activity types.

Action Parameters

Action Response

data
object
successful
boolean
error

Adds a new team to the company and returns the created object.

Action Parameters

description
string
name
stringRequired
manager_id
integerRequired
users
array

Action Response

data
object
successful
boolean
error

Updates an activity. includes more activities scheduled in context property in response’s additional data which indicates whether there are more undone activities scheduled with the same deal, person or organization (depending on the supplied data).

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates an existing team and returns the updated object.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a product to a deal, creating a new item called a deal-product.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a message to a conversation. to use the endpoint, you need to have messengers integration oauth scope enabled and the messaging manifest ready for the messaging app extension.

Action Parameters

id
stringRequired
channel_id
stringRequired
sender_id
stringRequired
conversation_id
stringRequired
message
stringRequired
status
stringRequired
created_at
stringRequired
reply_by
string
conversation_link
string
attachments
array

Action Response

data
object
successful
boolean
error

New filter creation returns an id. only one primary condition group with ‘and’ and two secondary groups (one ‘and’, one ‘or’) are supported. future syntax expansion possible. see tutorial for details.

Action Parameters

name
stringRequired

Action Response

data
object
successful
boolean
error

Marks a task as deleted. if the task has subtasks then those will also be deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns mail threads in a specified folder ordered by the most recent message within.

Action Parameters

folder
stringRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Lists the settings of an authorized user. example response contains a shortened list of settings.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns data about a specific deal field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about an authorized user within the company with bound company data: company id, company name, and domain. note that the locale property means ‘date/number format’ in the pipedrive account settings, not the chosen language.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks a field as deleted. for more information, see the tutorial for deleting a custom field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

The text describes an api endpoint that returns detailed person information, including extra fields and custom fields as hashes. it also provides data.marketing status if the campaigns product is used.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Performs a search from your choice of item types and fields.

Action Parameters

term
stringRequired
item_types
string
fields
string
search_for_related_items
boolean
exact_match
boolean
include_fields
string
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Lists updates about a person.if a company uses the campaigns product, then this endpoint’s response will also include updates for the marketing status field.

Action Parameters

id
integerRequired
start
integer
limit
integer
all_changes
string
items
string

Action Response

data
object
successful
boolean
error

Updates the properties of a user. currently, only active flag can be updated.

Action Parameters

id
integerRequired
active_flag
booleanRequired

Action Response

data
object
successful
boolean
error

Finds and returns an organization relationship from its id.

Action Parameters

id
integerRequired
org_id
integer

Action Response

data
object
successful
boolean
error

Returns all lead sources. please note that the list of lead sources is fixed, it cannot be modified. all leads created through the pipedrive api will have a lead source api assigned.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks a role as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists deals associated with an organization.

Action Parameters

id
integerRequired
start
integer
limit
integer
status
stringDefaults to all_not_deleted
sort
string
only_primary_association
integer

Action Response

data
object
successful
boolean
error

Adds a new stage, returns the id upon success.

Action Parameters

name
stringRequired
pipeline_id
integerRequired
deal_probability
integer
rotten_flag
boolean
rotten_days
integer

Action Response

data
object
successful
boolean
error

Marks a file as deleted. after 30 days, the file will be permanently deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists deals associated with a person.

Action Parameters

id
integerRequired
start
integer
limit
integer
status
stringDefaults to all_not_deleted
sort
string

Action Response

data
object
successful
boolean
error

Marks multiple activities as deleted. after 30 days, the activities will be permanently deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Marks multiple fields as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Returns data about all organization fields.

Action Parameters

start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Returns all the mail messages inside a specified mail thread.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Add a new contact in pipedrive with optional custom fields unique to each account found using the personfields endpoint. the endpoint also handles data.marketing status for campaigns product users.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks multiple activity types as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Returns the list of assignments for a permission set.

Action Parameters

id
stringRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Marks a filter as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists deals in a specific stage.

Action Parameters

id
integerRequired
filter_id
integer
user_id
integer
everyone
integer
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Marks multiple fields as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Merges a person with another person. for more information, see the tutorial for merging two persons.

Action Parameters

id
integerRequired
merge_with_id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all recent changes occurred after the given timestamp.

Action Parameters

since_timestamp
stringRequired
items
string
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

This api endpoint searches deals by title, notes, and custom fields, filters results by person or organization id, and is a specific use case of /v1/itemsearch with limited oauth scope.

Action Parameters

term
stringRequired
fields
string
exact_match
boolean
person_id
integer
organization_id
integer
status
string
include_fields
string
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Adds a new deal field. for more information, see the tutorial for adding a new custom field.

Action Parameters

Action Response

data
object
successful
boolean
error

Deletes an organization relationship and returns the deleted id.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists the settings of user’s assigned role.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Modifies a person’s details in pipedrive. see the linked tutorial for guidance. if utilizing campaigns, the endpoint also handles data.marketing status.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks multiple deal fields as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Returns data about deals that have a product attached to it.

Action Parameters

id
integerRequired
start
integer
limit
integer
status
stringDefaults to all_not_deleted

Action Response

data
object
successful
boolean
error

Adds a new goal. along with adding a new goal, a report is created to track the progress of your goal.

Action Parameters

title
string
interval
stringRequired

Action Response

data
object
successful
boolean
error

Marks multiple stages as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Returns all active project phases under a specific board.

Action Parameters

board_id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a new pipeline.

Action Parameters

name
stringRequired
order_nr
integer

Action Response

data
object
successful
boolean
error

The endpoint removes a messenger channel along with conversations and messages. requires messengers integration oauth and messaging app extension manifest.

Action Parameters

id
stringRequired

Action Response

data
object
successful
boolean
error

Returns the add-ons for a single company.

Action Parameters

Action Response

data
object
successful
boolean
error

Marks a mail thread as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns all supported currencies in given account which should be used when saving monetary values with other objects. the code parameter of the returning objects is the currency code according to iso 4217 for all non-custom currencies.

Action Parameters

term
string

Action Response

data
object
successful
boolean
error

The text provides links to documentation for adding or updating filters, and information on all supported filter helpers in an api. it encourages consulting a tutorial for more details on adding a filter.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns data about a specific mail message.

Action Parameters

id
integerRequired
include_body
integer

Action Response

data
object
successful
boolean
error

Duplicates a deal.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists activities associated with an organization.

Action Parameters

id
integerRequired
start
integer
limit
integer
done
integer
exclude
string

Action Response

data
object
successful
boolean
error

Lists the followers of a deal.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Adds a new note.

Action Parameters

Action Response

data
object
successful
boolean
error

Lists mail messages associated with a person.

Action Parameters

id
integerRequired
start
integer
limit
integer

Action Response

data
object
successful
boolean
error

Updates the properties of a mail thread.

Action Parameters

id
integerRequired
deal_id
integer
lead_id
string

Action Response

data
object
successful
boolean
error

Returns data about a specific person field.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns data about all filters.

Action Parameters

type
string

Action Response

data
object
successful
boolean
error

Marks multiple fields as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error

Adds a new product to the products inventory. for more information, see the tutorial for adding a product.

Action Parameters

Action Response

data
object
successful
boolean
error

Returns all projects. this is a cursor-paginated endpoint. for more information, please refer to our documentation on pagination.

Action Parameters

cursor
string
limit
integer
filter_id
integer
status
string
phase_id
integer
include_archived
boolean

Action Response

data
object
successful
boolean
error

Returns the details of a specific project. also note that custom fields appear as long hashes in the resulting data. these hashes can be mapped against the key value of project fields.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Marks an activity type as deleted.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Returns details of an installment or a recurring subscription.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Lists aggregated permissions over all assigned permission sets for a user.

Action Parameters

id
integerRequired

Action Response

data
object
successful
boolean
error

Updates an existing filter.

Action Parameters

id
integerRequired
name
string

Action Response

data
object
successful
boolean
error

Marks multiple filters as deleted.

Action Parameters

ids
stringRequired

Action Response

data
object
successful
boolean
error