Integromat
  • Back to website
Articles in this section
  • Formstack
  • Magento 2
  • Google Cloud Vision
  • ManyChat
  • Airtable
  • Bubble
  • Email (legacy)
  • Facebook Groups
  • Google Sheets (legacy)
  • HTTP
See more
  1. Integromat Support
  2. Apps
  3. Docs

Pipedrive CRM

Integromat Support Team Integromat Support Team Updated November 26, 2020 11:56
This is a documentation of the new Pipedrive CRM app.
Here is a documentation of the legacy Pipedrive CRM (legacy) app.

Getting Started with Pipedrive CRM
Connecting Pipedrive CRM to Integromat
Deals
New Deal Event
Watch Deals
Create a Deal
Update a Deal
Delete a Deal
Get a Deal
List Deals
List Deals in a Pipeline
List Deals in Stage
Products in a Deal
Add a Product to a Deal
List Products in a Deal
Persons in a Deal
List Persons in a Deal
Files in a Deal
List Files in a Deal
Activities in a Deal
List Activities in a Deal
Organizations
New Organization Event
Watch Organizations
Create an Organization
Update an Organization
Delete an Organization
Get an Organization
List Organization
Persons
New Person Event
Create a Person
Delete a Person
List Persons
Find a Person by Name
Products
New Product Event
Create a Product
Update a Product
Delete a Product
Get a Product
List Products
Notes
New Note Event
Watch Notes
Create a Note
Update a Note
Delete a Note
Get a Note
List Notes
Activities
New Activity Event
Watch Activities
Create an Activity
Update an Activity
Delete an Activity
List Activities
Mail
Update a Mail Thread Details
Delete a Mail Thread
Get a Mail Thread
List Mail Threads
List Messages in a Thread
Followers
Add a Follower
Delete a Follower
List Followers
Users
Get a User
List Users
Other
Upload a File
List Pipelines
List Stages
Search Objects
Make an API Call

Getting Started with Pipedrive CRM

The Pipedrive CRM modules allow you to monitor deals, organizations, persons, products, notes, and activities and create, update, list, or delete deals, products in a deal, persons in a deal, files in a deal, activities in a deal, organizations, persons, products, notes, activities, emails, followers, or users in your Pipedrive CRM account.

Prerequisites

  • A Pipedrive CRM account

In order to use Pipedrive CRM with Integromat, it is necessary to have a Pipedrive CRM account. If you do not have one, you can create a Pipedrive CRM account at www.pipedrive.com/en/register.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Pipedrive CRM to Integromat

To connect your Pipedrive CRM account to Integromat using the preferred connection method (API Token), you need to obtain the personal API token from your account.

1. Log in to your Pipedrive account.

2. Click on your name in the top-right corner and select Personal Preferences.

3. Open the API tab.

lU9NhvGWMV.gif

4. Copy your personal API token.

explorer_9y9Xgsvh7h.png

5. Go to Integromat and open the Pipedrive module's Create a connection dialog.

6. In the Connection type field, select the Pipedrive API token (preferred) option.

7. Enter the API token you have copied in step 4 to the respective field and click the Continue button to establish the connection.

Deals

New Deal Event

Triggers when a new deal is added, changed (updated), or deleted.

Webhook name Enter the name of the webhook, e.g. "Added Deal Webhook".
Connection Select or establish a connection to your Pipedrive CRM account.
Event action Select the event that triggers the module. By selecting All, every event triggers the module.
HTTP basic auth username Enter the basic auth username if needed.
HTTP basic auth password Enter the basic auth password if needed.

Watch Deals

Returns deal details when a deal is added or updated.

Connection Select or establish a connection to your Pipedrive CRM account.
Stage If selected, only deals in the selected sales stage are returned.
Filter

Returns only deals by the selected filter. Filters can be added or edited in the following dialog:

2019-04-25_13_39_55-Window.png

Owned by you When the Yes option is selected, only deals owned by you are returned. The Filter field takes precedence over Owned by you when both are supplied.
Status Returns only deals with a selected status. If omitted, all of the not deleted deals are returned.
Limit Set the maximum number of deals Integromat will return during one cycle.
Trigger when Select whether you want to trigger the module when the deal is created (Object created) or updated (Object updated).

Create a Deal

Adds a new deal

Connection Select or establish a connection to your Pipedrive CRM account.
Title Enter the deal title.
Value Enter the value of the deal. If left empty, the value will be set to 0.
Currency Enter the currency of the deal. Accepts a 3-character currency code. If left empty, the currency will be set to the default currency of the authorized Pipedrive user.
User Select a user or map the ID of the user who will be marked as the owner of this deal. If the field is left empty, the authorized user ID will be used.
Person Enter the ID of the person the deal will be associated with. You can search for the person by name or by email address. To search the person, click the Search button and enter the search term into the Query field. If a match is found, the ID of the person is inserted to the Person field.
Organization Enter the ID of the organization the deal will be associated with. To search the organization, click the Search button and enter the search term into the Query field. If a match is found, the ID of the organization is inserted to the Organization field.
Stage Select the sales stage or map the ID of the stage the deal will be placed in the pipeline of. If left empty, the deal will be placed in the first stage of the default pipeline.
Status Select or map the status of the new deal.
Probability

The deal success probability percentage. Used only when Deal probability for the pipeline of the deal is enabled.

You can enable the probability in Pipeline Settings > Pipelines > switch Deal probability to Yes.
Lost reason

Enter the message about why the deal was lost (to be used when status=lost).

Add time

Enter the creation date & time of the deal in UTC. Format: YYYY-MM-DD HH:MM:SS

Visible to

Select whether the deal will be visible (the ability to see and edit details of the deal) to the Owner & Followers only or to the Entire company.

Update a Deal

Updates an existing deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID
Enter (map) the deal ID of the deal you want to update.

The descriptions of the module's fields can be found in the Create a Deal module section.

Delete a Deal

Deletes a specified deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID
Enter (map) the deal ID of the deal you want to delete.

Get a Deal

Retrieves the details of a specific deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID
Enter (map) the Deal ID of the deal you want to delete.

List Deals

Returns all deals based on filter settings.

Connection Select or establish a connection to your Pipedrive CRM account.
Stage If selected, only deals in the selected sales stage are returned.
Filter

Returns only deals by the selected filter. Filters can be added or edited in the following dialog:

2019-04-25_13_39_55-Window.png

User If the user is selected, only deals matching the user are returned.
Status Returns only deals with the selected status. If omitted, all of the not deleted deals are returned.
Limit Set the maximum number of deals Integromat will return during one cycle.

List Deals in a Pipeline

Lists the deals in a specific pipeline across all its stages.

Connection Select or establish a connection to your Pipedrive CRM account.
Pipeline Select or map the pipeline you want to list deals from.
Stage Returns only deals in the selected stage.
Filter Select the status of the deal to filter returned deals by.
User Select the user that is assigned to the deals you want to return. If provided, the Filter field will not be considered and only deals owned by the given user will be returned. If left empty, deals owned by the authorized user will be returned.
Everyone If the Yes option is selected, Filter and User fields will not be taken into account – instead, deals owned by everyone will be returned.
Limit Set the maximum number of deals Integromat will return during one cycle.

List Deals in a Stage

This module lists the deals in a specified stage.

Connection Select or establish a connection to your Pipedrive CRM account.
Stage Select the stage you want to list deals from.
Filter If you select one of the options, only deals matching the selected filter will be returned.
User Select the user that is assigned to the deals you want to return. If provided, the Filter field will not be considered and only deals owned by the given user will be returned. If left empty, deals owned by the authorized user will be returned.
Everyone If the Yes option is selected, Filter and User fields will not be taken into account – instead, deals owned by everyone will be returned.
Limit Set the maximum number of deals Integromat will return during one cycle.

Product in a Deal

Add a Product to a Deal

Adds a product to a deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to add the product to.
Product ID

Enter or map the Product ID you want to add to the deal.

The product must be already created. You can use the Create a Product module to create a new product.
Item price Price of the product that will be added to the deal.
Quantity Enter the number of products (product items) that will be added to the deal.
Discount percentage Discount listed as a percentage. If left empty, 0 discount will be set.
Duration of the product

Enter the duration of the product. When product durations are not enabled for the company, or if omitted, it defaults to 1.

This is useful in the context of both time- and amount-related products, such as hoteling or warehouse services. Example: you may want to sell 500 square feet of office space for 3 months, while the price of the product is defined per one square foot. This option requires the Products option to be enabled.
To enable Product duration go to Settings > Customize > Features and switch Product durations to On.
Product variant ID Enter the ID of the product variation to use. When the field is left empty, no variation will be used.
Comments Enter a comment for the product and deal association. The comment is visible and editable in the application UI.
Enabled flag Set whether the product is enabled on the deal or not. This makes it possible to add products to a deal with specific price and discount criteria - but keeping them disabled, refrains them from being included in the deal price calculation. When omitted, the product will be marked as enabled by default.

Update Product Attachment Details

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

Please find the descriptions of the fields in the Add a Product to a Deal section above.

Delete an Attached Product

Deletes a product attachment from a deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to delete a product attachment from.
Product attachment ID
Enter (map) the ID of the attachment you want to delete.  This is returned as product_attachment_id after attaching a product to a deal or as id in the output of the List Products in a Deal module.

List Products in a Deal

Lists products attached to a deal and retrieves its details.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to list the products from.
Limit
Set the maximum number of deals Integromat will return during one cycle.

Persons in a Deal

Add a participant to a deal

Adds a participant to a deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to add the participant to.
Person
Enter or map the ID of the person you want to add as a participant to the deal. You can search for the person by name or by email address. To search the person, click the Search button and enter the search term into the Query field. If a match is found, the ID of the person is inserted to the Person field.

List Persons in a Deal

Lists all the persons (with details) associated with a deal, regardless of whether the person is the primary contact of the deal, or added as a participant.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to list the persons from.
Limit Set the maximum number of persons Integromat will return during one cycle.

Files in a Deal

List Files in a Deal

Retrieves files that were added to a specified deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to list the persons from.
Include deleted files Select whether to include files that have already been deleted.

Activities in a Deal

List Activities in a Deal

Lists activities associated with a deal.

Connection Select or establish a connection to your Pipedrive CRM account.
Deal ID Enter or map the ID of the deal you want to list the activities from.
Done Select whether you want to retrieve only activities that were marked as done or not. If the Not defined option is selected, then both - done and undone activities - are retrieved.
Limit Set the maximum number of activities Integromat will return during one cycle.

Organizations

New Organization Event

Triggers when a new organization is added, updated or deleted.

Webhook name Enter the name of the webhook, e.g. "Added Organization Webhook".
Connection Select or establish a connection to your Pipedrive CRM account.
Event action Select the event that triggers the module. By selecting All, every event triggers the module.
HTTP basic auth username Enter the basic auth username if needed.
HTTP basic auth password Enter the basic auth password if needed.

Watch Organizations

Triggers when a new organization is added or updated.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter Returns only organizations by a selected filter.
User Select the user or map the ID of the user who will be marked as the owner of the organization. If the field is left empty, the authorized user ID will be used.
Limit Set the maximum number of organizations Integromat will return during one cycle.
Trigger when Select whether you want to trigger the module when the organization is created (Object created) or updated (Object updated).

Create an Organization

Adds a new organization.

Connection Select or establish a connection to your Pipedrive CRM account.
Name Enter the name of the organization you want to create.
Owner Enter the ID of the user who will be marked as the owner of the organization. When left empty, the authorized user ID will be used. You can search for ID using the Search button and entering the name of the user in the Query field.
Visible to Select whether the created organization will be visible (the ability to see and edit details of the deal) to the Owner & Followers only or to the Entire company.
Add time Enter the date and time when the organization is created (optional). Use the following date and time format: YYYY-MM-DD HH:MM:SS

2019-04-29_10_21_43-Integration_Pipedrive_CRM___Integromat.png

Update an Organization

Updates the properties of an organization.

Connection Select or establish a connection to your Pipedrive CRM account.
Name Enter the name of the organization you want to update.
Owner Enter the ID of the user who will be marked as the owner of this organization. When left empty, the authorized user ID will be used. You can search for the ID using the Search button and entering the name of the user to the Query field.
Visible to Select whether the updated organization will be visible (the ability to see and edit details of the organization) to the Owner & Followers only or to the Entire company.
Add time Enter the date and time when the organization is created (optional). Use the following date and time format: YYYY-MM-DD HH:MM:SS

Delete an Organization

Deletes a selected organization.

Connection Select or establish a connection to your Pipedrive CRM account.
Organization ID

Enter the ID of the organization you want to delete.

You can map the ID from another module or find it in the Pipedrive CRM user interface in the URL:

LIToxKfWKM.gif

Get an Organization

Retrieves details for a specified organization.

Connection Select or establish a connection to your Pipedrive CRM account.
Organization ID Enter the ID of the organization you want to retrieve details about.

List Organizations

Retrieves all organizations.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter

Enter or select the desired filter. You can create or edit filters in the Pipedrive CRM user interface.

2019-04-29_13_26_01-Organizations.png

User Map or select the user. If supplied, only organizations owned by the entered user will be returned.
First char Enter the first letter of the organization's name you want to retrieve.
Limit Set the maximum number of organizations Integromat will return during one cycle.

Update an Organization Field Value

Updates an organization field.

Connection Select or establish a connection to your Pipedrive CRM account.
Organization ID Enter (map) the Organization ID of the organization you want to update field values for.
Fields Define fields and values to be updated.

Persons

Do not confuse persons with users! Persons are the customers you are doing deals with.

New Person Event

Triggers when a new person is added, updated or deleted.

Webhook name Enter the name of the webhook, e.g. "Added Person Webhook".
Connection Select or establish a connection to your Pipedrive CRM account.
Event action Select the event that triggers the module. By selecting All, every event triggers the module.
HTTP basic auth username Enter the basic auth username if needed.
HTTP basic auth password Enter the basic auth password if needed.

Watch Persons

Triggers when a new person is added or updated.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter

Returns only persons by the selected filter.

User Select the user. If supplied, only persons owned by the selected user will be returned.
Limit Set the maximum number of persons Integromat will return during one cycle.
Trigger when Select whether you want to trigger the module when the person is created (Object created) or updated (Object updated).

Create a Person

Adds a new person and returns the new person's ID.

Connection Select or establish a connection to your Pipedrive CRM account.
Name Enter the name of the new contact.
Owner Enter the ID of the user who will be marked as the owner of this person. When left empty, the authorized user ID will be used. You can search for the ID using the Search button and entering the name of the user to the Query field. The input is case sensitive.
Organization Enter the ID of the organization this person belongs to. You can search for the ID using the Search button and entering the name of the organization to the Query field. The input is case sensitive.
Emails Enter the contact email address.
Phones Enter the contact phone number.
Add time Enter the date and time when the person is created (optional). Use the following date and time format: YYYY-MM-DD HH:MM:SS
Visible to Select whether the new person will be visible (the ability to see and edit details of the person) to the Owner & Followers only or to the Entire company.

Update a Person

Updates personal details of a contact.

Connection Select or establish a connection to your Pipedrive CRM account.
Person ID Enter or map the ID of the person you want to update.
Name Enter the name of the person you want to update.
Owner Enter the ID of the user who will be marked as the owner of this person. When left empty, the authorized user ID will be used. You can search for the ID using the Search button and entering the name of the user to the Query field. The input is case sensitive.
Organization Enter the ID of the organization this person belongs to. You can search for the ID using the Search button and entering the name of the organization to the Query field.
Emails Enter the updated email for the person.
Phones Enter the updated phone for the person.
Add time Enter the date and time when the person is created (optional). Use the following date and time format: YYYY-MM-DD HH:MM:SS
Visible to Select whether the updated person will be visible (the ability to see and edit details of the person) to the Owner & Followers only or to the Entire company.

Delete a Person

Deletes a selected person.

Connection Select or establish a connection to your Pipedrive CRM account.
Person ID Enter or map the ID of the person you want to delete.

Get a Person

Retrieves details of a desired person (including custom fields).

Connection Select or establish a connection to your Pipedrive CRM account.
Person ID Enter or map the ID of the person you want to retrieve information about.

List Persons

Returns a list of persons defined by a specified filter (without custom fields).

Connection Select or establish a connection to your Pipedrive CRM account.
Filter Returns only persons that fit the selected filter.
User Select or map the user. If supplied, only persons owned by the selected user will be returned.
First char Enter the first letter of the organization's name you want to retrieve.
Limit Set the maximum number of persons Integromat will return during one cycle.

Find a Person by Name or Email

Searches through all persons by a specified name or email address.

Connection Select or establish a connection to your Pipedrive CRM account.
Term Enter the search term.
Organization Enter the ID of the organization the person you are looking for belongs to. You can search for the ID using the Search button and entering the name of the organization to the Query field.
Search by email

If the Yes option is selected the search term will only be matched against email addresses of people.

Products

New Product Event

Triggers when a new product is added, updated or deleted.

Webhook name Enter the name of the webhook, e.g. "Added Product Webhook".
Connection Select or establish a connection to your Pipedrive CRM account.
Event action Select the event that triggers the module. By selecting All, every event triggers the module.
HTTP basic auth username Enter the basic auth username if needed.
HTTP basic auth password Enter the basic auth password if needed.

Watch Products

Retrieves product details when a product is added or updated.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter

Returns only products by the selected filter.

User Select the user. If supplied, only products owned by the selected user will be returned.
Limit Set the maximum number of products Integromat will return during one cycle.
Trigger when Select whether you want to trigger the module when the product is created (Object created) or updated (Object updated).

Create a Product

Adds a new product.

Connection Select or establish a connection to your Pipedrive CRM account.
Name Enter the name of the product.
Code Enter the product code.
Unit Enter the unit of the product, e.g. kg, pcs, lbs,...
Tax Enter the tax in percentage (%).
This product is active Select whether the created product will be set as active.
Owner Enter the ID of the user who will be marked as the owner of this product. When left empty, the authorized user ID will be used. You can search for the ID using the Search button and entering the name of the user to the Query field. The input is case sensitive.
Visible to Select whether the created product will be visible (the ability to see and edit details of the product) to the Owner & Followers only or to the Entire company.
Prices

Set the price information (Unit price, Currency, Cost (Cost per unit), Overhead cost (Direct cost)). For the currency format use ISO 4217 Code, e.g. USD.

There can only be one price per product per currency.

Update a Product

Updates data for a product.

Connection Select or establish a connection to your Pipedrive CRM account.
Product ID Enter or map the ID of the product you want to update.

Description of the module's fields can be found above in the Create a Product section.

Delete a Product

Deletes a product.

Connection Select or establish a connection to your Pipedrive CRM account.
Product ID Enter or map the ID of the product you want to delete.

Get a Product

Retrieves details for a specified product.

Connection Select or establish a connection to your Pipedrive CRM account.
Product ID Enter or map the ID of the product you want to retrieve details about.

List Products

Returns data about all products based on the filter settings.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter Returns products by the selected filter.
User Select or map the user. If supplied, only products owned by the selected user will be returned.
First char Enter the first letter of the product's name you want to retrieve.
Limit Set the maximum number of products Integromat will return during one cycle.

Notes

New Note Event

Triggers when a new note is added, updated or deleted.

Webhook name Enter the name of the webhook, e.g. "Added Note Webhook".
Connection Select or establish a connection to your Pipedrive CRM account.
Event action Select the event that triggers the module. By selecting All, every event triggers the module.
HTTP basic auth username Enter the basic auth username if needed.
HTTP basic auth password Enter the basic auth password if needed.

Watch Notes

Triggers when a new note is added or updated.

Connection Select or establish a connection to your Pipedrive CRM account.
User Enter or map the ID of the user whose notes to retrieve. If left empty, all of the notes by all users will be retrieved.
Deal Enter or map the ID of the deal which notes to retrieve. If left empty, all of the notes about all deals will be returned.
Person Enter or map the ID of the person (contact) whose notes to retrieve. If left empty, notes by all persons will be retrieved.
Organization Enter the ID of the organization the notes you want to retrieve for belongs to. You can search for the ID using the Search button and entering the name of the organization in the Query field.
Pinned to deal flag Select if you want to filter notes by pinned to deal notes.
Pinned to organization Select if you want to filter notes by pinned to organization notes.
Pinned to person flag Select if you want to filter notes by pinned to person notes.
Limit Set the maximum number of notes Integromat will return during one cycle.
Trigger when Select whether you want to trigger the module when the note is created (Object created) or updated (Object updated).

Create a Note

Adds a note.

Connection Select or establish a connection to your Pipedrive CRM account.
Content Enter the text content of the new note. You can format the text using HTML.
Deal ID Enter (map) the ID of the deal the note will be attached to.
Person Enter (map) the ID of the person the note will be attached to. You can search for the ID using the Search button and entering the name of the person to the Query field.
Organization Enter (map) the ID of the organization the note will be attached to. You can search for the ID using the Search button and entering the name of the organization in the Query field.
Add time Optional creation date & time of the note in UTC. Can be set in the past or in the future. Format: YYYY-MM-DD HH:MM:SS
Pinned to deal flag Select if you want to pin the note to deal. If enabled, then the deal ID must be supplied.
Pinned to organization Select if you want to pin the note to deal. If enabled, then the organization ID must be supplied.
Pinned to person flag Select if you want to pin the note to deal. If enabled, then the person ID must be supplied.

Update a Note

Updates the content of a note.

Connection Select or establish a connection to your Pipedrive CRM account.
Note ID Enter (map) the ID of the note you want to update.

Description of the module's fields can be found above in the Create a Note section of this article.

Delete a Note

Deletes a note.

Connection Select or establish a connection to your Pipedrive CRM account.
Note ID Enter (map) the ID of the note you want to delete.

Get a Note

Retrieves details of a note.

Connection Select or establish a connection to your Pipedrive CRM account.
Note ID Enter (map) the ID of the note you want to retrieve information about.

List Notes

Retrieves details about all notes based on filter settings.

Connection Select or establish a connection to your Pipedrive CRM account.
User Enter or map the ID of the user whose notes to retrieve. If left empty, all of the notes by all users will be retrieved.
Deal Enter or map the ID of the deal whose notes to retrieve. If left empty, all of the notes about all deals will be returned.
Person Enter or map the ID of the person (contact) whose notes to retrieve. If left empty, notes by all persons will be retrieved.
Organization Enter the ID of the organization whose notes you want to retrieve. You can search for the ID using the Search button and entering the name of the organization in the Query field.
Pinned to deal flag Select if you want to filter notes by pinned to deal notes.
Pinned to organization Select if you want to filter notes by pinned to organization notes.
Pinned to person flag Select if you want to filter notes by pinned to person notes.
Start date Date in YYYY-MM-DD HH:MM:SS format from which notes to retrieve from.
End date Date in YYYY-MM-DD HH:MM:SS format from which notes to retrieve to.
Limit Set the maximum number of activities Integromat will return during one cycle.

Activities

New Activity Event

Triggers when a new activity is added, updated or deleted.

Webhook name Enter the name of the webhook, e.g. "Added Activity Webhook".
Connection Select or establish a connection to your Pipedrive CRM account.
Event action Select the event that triggers the module. By selecting All, every event triggers the module.
HTTP basic auth username Enter the basic auth username if needed.
HTTP basic auth password Enter the basic auth password if needed.

Watch Activities

Triggers when a new activity is added or updated.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter Select the filter. The filter must be already created via the Pipedrive user interface.
Type Select the type of activity you want to watch for.
User Select the user whose activities will be retrieved. If no user is selected, activities for all company users will be retrieved based on the permission sets.
This activity is done Select whether the activity is done (Yes), or undone (No). If not defined, then all activities are returned.
Trigger when Select whether you want to trigger the module when the activity is created (Object created) or updated (Object updated).

Create an Activity

Adds a new activity.

Connection Select or establish a connection to your Pipedrive CRM account.
Subject Enter the title of the activity you want to add.
Type Select the type of activity you want to create.
Due date and time Enter the due date of the activity in YYYY-MM-DD HH:MM format.
Duration Enter the duration of the activity in UTC. Format: HH:MM.
User Select or map the user you want to assign the activity to.
Deal Enter the ID of the deal this activity will be associated with.
Person Enter (map) the ID of the person you want to link to the activity. You can search for the ID using the Search button and entering the name of the person in the Query field.
Organization Enter the ID of the organization this activity will be linked to. You can search for the ID using the Search button and entering the name of the organization in the Query field.
Note Enter note text content. You can format the note using HTML.
Participants

Enter the participants this activity will be linked to.

If left empty, only the person specified in the Person field (above) will be used.

Update an Activity

Modifies the activity.

Connection Select or establish a connection to your Pipedrive CRM account.
Activity ID Enter or map the ID of the activity you want to update.

Description of the module's fields can be found above in the Create an Activity section of this article.

Delete an Activity

Deletes an activity.

Connection Select or establish a connection to your Pipedrive CRM account.
Activity ID Enter or map the ID of the activity you want to delete.

Get an Activity

Retrieves details of a specific activity.

Connection Select or establish a connection to your Pipedrive CRM account.
Activity ID Enter or map the ID of the activity you want to retrieve the details about.

List Activities

Lists activities by defined filter settings.

Connection Select or establish a connection to your Pipedrive CRM account.
Filter Select the activities filter. The filter must be already created via the Pipedrive user interface.
Type Select the type of activity you want to list.
User Select the user whose activities will be retrieved. If no user is selected, activities for all company users will be retrieved based on the permission sets.
Start date Enter the date in the format of YYYY-MM-DD from which activities to retrieve from.
End date Enter the end date in the format of YYYY-MM-DD until which activities to retrieve to.
Activity is done Select whether the activity is done (Yes), or undone (No). If not defined, then all activities are returned.
Limit Set the maximum number of activities Integromat will return during one cycle.

Mail

Update a Mail Thread Details

Modifies the properties of a mail conversation.

Connection Select or establish a connection to your Pipedrive CRM account.
Mail Thread ID Enter (map) the ID of the mail conversation you want to update.
Deal ID Enter (map) ID of the deal this thread is associated with.
Shared flag Set whether to share this thread with other users in your company.
Read flag Set whether this thread is read or unread.
Archived flag Set whether this thread is archived or not. You can only archive threads that belong to the Inbox folder. Archived threads will disappear from the Inbox.

Delete a Mail Thread

Deletes an email conversation from Pipedrive. This action cannot be undone.

Connection Select or establish a connection to your Pipedrive CRM account.
Mail Thread ID Enter (map) the ID of the mail conversation you want to delete.

Get a Mail Thread

Retrieves details on a mail conversation.

Connection Select or establish a connection to your Pipedrive CRM account.
Mail Thread ID Enter (map) the ID of the mail conversation you want to retrieve information about.

Get a Message

Retrieve message details.

Connection Select or establish a connection to your Pipedrive CRM account.
Message ID Enter (map) the ID of the message you want to retrieve details about.

List Mail Threads

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

Connection Select or establish a connection to your Pipedrive CRM account.
Folder Select the folder you want to retrieve mail conversations from.
Limit Set the maximum number of mail threads Integromat will return during one cycle.

List Messages in a Thread

Retrieves mail messages inside a specified mail conversation.

Connection Select or establish a connection to your Pipedrive CRM account.
Mail Thread ID

Enter (map) the ID of the mail conversation you want to retrieve mail messages from

Followers

Add a Follower

Adds a follower (user) to a selected object.

Connection Select or establish a connection to your Pipedrive CRM account.
Object Select whether you want to add a follower to a deal, organization, person, or product.
Object ID Enter the ID of the deal, organization, person, or product you want to add a follower to.

Delete a Follower

Deletes a follower from the selected deal, organization, person, or product.

Connection Select or establish a connection to your Pipedrive CRM account.
Object Select whether you want to delete a follower from a deal, organization, person, or product.
Follower ID Enter the ID of the follower.
The ID can be retrieved using the List Followers module.

List Followers

Lists the followers of a selected deal, organization, person, product, or user.

Connection Select or establish a connection to your Pipedrive CRM account.
Object Select whether you want to list followers from a deal, organization, person, product, or user.
Object ID Enter the ID of the deal, organization, person, product, or user you want to list the followers from.

Users

Get a User

Retrieves information about a specified user account.

Connection Select or establish a connection to your Pipedrive CRM account.
User ID

Enter (map) the ID of the user you want to retrieve information about.

List Users

Retrieves details about all users within the company.

Connection Select or establish a connection to your Pipedrive CRM account.

Other

Upload a File

Allows you to upload a file to a deal, person, organization, product, or activity.

Connection Select or establish a connection to your Pipedrive CRM account.
Source file

Enter or map (e.g. using Dropbox module) the file you want to upload.

File name
Enter the name of the uploaded file.

Data
Map or enter the data of the file.

For more information refer to the Working with files article.

Deal ID
Person ID
Organization ID
Product ID
Activity ID

Enter the ID of the object you want to associate the uploaded file with.

You can enter IDs into multiple fields in order to associate the file with multiple objects.

List Pipelines

Retrieves information about all pipelines in your Pipedrive account.

Connection Select or establish a connection to your Pipedrive CRM account.

List Stages

Retrieves information about sales stages in a selected pipeline.

Connection Select or establish a connection to your Pipedrive CRM account.
Pipeline

Select (or map the Pipeline ID) of the pipeline you want to retrieve the sales stages from.

Search Objects

Performs a search across your Pipedrive account and returns results.

Connection Select or establish a connection to your Pipedrive CRM account.
Term

Enter the search term. The minimum length is 2 characters.

Item type

Select the object you want to search for. If the field is left empty, all objects are searched.

Exact match

If the option is enabled, then only the exact match against the search term will be returned.

Limit

Set the maximum number of results Integromat will return during one cycle.

Make an API Call

Allows you to perform a custom API call.

Connection Select or establish a connection to your Pipedrive CRM account.
URL Enter a path relative to https://api-proxy.pipedrive.com/. E.g. deals.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

Headers Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String Enter the request query string.
Body Enter the body content for your API call. Usually JSON.

Example

The following simple API call retrieves all persons.

2019-05-03_14_58_24-Integration_Pipedrive_CRM___Integromat.png

The result can be found in Bundle > Body > data.

The details of 7 persons are returned:

2019-05-03_15_00_33-Integration_Pipedrive_CRM___Integromat.png

 

Was this article helpful?
0 out of 5 found this helpful
Menu
  • Features
  • Apps & Services
  • Templates
  • Pricing
  • What's new
  • Use cases
Information
  • Terms,  Privacy
  • FAQ
  • Help & Tutorials
  • Community
  • Affiliate Program
  • Blog
Developers
  • Developer Platform
Company
  • About the company
  • Join our team
  • Contact
Follow us
© 2020 Integromat by Celonis. All rights reserved. Integromat® is a registered trademark.
  • English