Pipedrive
The Pipedrive piece in ZBrain Flow provides comprehensive integration with Pipedrive's CRM platform, allowing you to manage sales processes and customer relationships directly from your workflows. This powerful connector enables you to create, update, and query various CRM entities without manual intervention. With Pipedrive integration, you can build automations that maintain sales records, track deals, manage contacts, organize activities, attach documents, and synchronize information across your business systems. This piece is ideal for sales teams looking to streamline their CRM operations, automate repetitive tasks, and ensure consistent data management across their sales pipeline.
How to use Pipedrive in ZBrain Flow
Select Pipedrive as your connection
Click on the '+' button in the Flow and search for Pipedrive.
Select Pipedrive.
Decide on the action you need, then select it. ZBrain Flow provides numerous options across these categories:
Deal Management: Create Deal, Update Deal, Find Deal, Add Product to Deal, Find Deals Associated With a Person
Contact Management: Create Person, Update Person, Find Person, Add Labels to Person
Organization Operations: Create Organization, Update Organization, Find Organization
Activity Tracking: Create Activity, Update Activity, Find Activity
Product Management: Create Product, Find Product, Retrieve a Product
Lead Management: Create Lead, Update Lead
Note Operations: Create Note, Retrieve a Note, Find Notes
File Management: Attach File
User Operations: Find User, Add Follower
Custom API Call: Make specialized requests to the Pipedrive API
How to connect to Pipedrive
Before using any Pipedrive action in ZBrain Flow, you must first create a connection with your Pipedrive account.
To create the connection, open the 'Connection' dropdown, click on 'Create connection'.
A new window will appear where you need to complete the following fields:
Enter a name for your connection in the 'Connection Name' field.
Click 'Connect' to authenticate and link your Pipedrive account.
Click 'Save' to create the connection.
How to assign users to track Pipedrive records
Configuration steps:
Once you create a connection, navigate to the 'Follower' dropdown and select the Pipedrive user who should follow the object.
From the 'Target Object' dropdown, select the type of record to be followed:
Deal
Person
Organization
Product
From the 'Target Object ID' dropdown, select the specific record that will be followed. The ID identifies the exact deal, person, organization, or product in your Pipedrive account.
How to retrieve a note
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
In the 'Note ID' field, enter the unique identifier of the note you want to retrieve.
How to create a note in Pipedrive
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
In the 'Content' field, enter the text you want to include in your note.
You can link your note to existing Pipedrive records and pin it for visibility:
From the 'Deal' dropdown, optionally select a deal to associate with this note.
Toggle 'Pin note to deal?' on to make it prominently visible on the deal.
From the 'Person' dropdown, optionally select a contact to associate with this note.
Toggle 'Pin note to person?' on to make it prominently visible on the contact record.
From the 'Organization' dropdown, optionally select a company to associate with this note.
Toggle 'Pin note to organization?' on to make it prominently visible on the company profile.
From the 'Lead' dropdown, optionally select a lead to associate with this note.
Toggle 'Pin note to lead?' on to make it prominently visible on the lead.
How to add a label to a person
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
From the 'Person' dropdown, select the contact you want to categorize with labels. This displays available contacts from your Pipedrive database.
In the 'Label' field, specify the labels you want to associate with this contact. Only existing labels in your Pipedrive account can be used.
How to add a product to a deal
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
From the 'Deal' dropdown, select the sales opportunity to which you want to add a product.
From the 'Product' dropdown, choose the specific product you want to associate with this deal.
In the 'Price' field, enter the unit price for this product.
In the 'Quantity' field, specify how many units of the product are being sold.
In the 'Discount' field, optionally enter any discount amount or percentage.
From the 'Discount Type' dropdown, select whether the discount is a percentage or an absolute amount.
In the 'Comments' field, optionally add any notes specific to this product line item.
Toggle 'Enable Product?' on to make the product active in the deal.
From the 'Tax Method' dropdown, select how tax should be calculated.
In the 'Tax Percentage' field, enter the applicable tax rate if relevant.
How to attach a file to Pipedrive records
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
In the 'File' field, upload or specify the file you want to attach. This can be a document, image, spreadsheet, presentation, or any other supported file type.
In the 'File Name' field, enter how you want the file to be named in Pipedrive.
You can link your file to one or more existing Pipedrive records:
From the 'Deal' dropdown, optionally select a deal to associate this file with.
From the 'Person' dropdown, optionally select a contact to attach this file to.
From the 'Organization' dropdown, optionally select a company to link this file to.
From the 'Product' dropdown, optionally select a product to connect this file with.
In the 'Activity ID' field, optionally enter an activity to attach this file to.
How to create an activity
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
In the 'Subject' field, enter a descriptive title for the activity. This should clearly indicate what needs to be done.
You can link your activity to existing Pipedrive records:
From the 'Organization' dropdown, optionally select a company related to this activity.
From the 'Person' dropdown, optionally select a contact involved in this activity.
From the 'Deal' dropdown, optionally select a sales opportunity connected to this activity.
From the 'Lead' dropdown, optionally select a lead associated with this activity.
From the 'Assign To' dropdown, select which user should be responsible for completing this activity.
From the 'Activity Type' dropdown, choose the category that best describes this task (call, meeting, email, etc.).
In the 'Due Date' field, enter when the activity should be completed (YYYY-MM-DD format).
In the 'Due Time' field, optionally specify a due time (HH:MM format).
In the 'Duration' field, indicate how long the activity will take (HH:MM format).
Toggle 'Mark as Done?' on if the activity is already completed.
From the 'Free or Busy' dropdown, select how this should appear on calendars.
In the 'Note' field, optionally add private details about the activity.
In the 'Public Description' field, optionally add details visible to everyone with access.
How to modify an activity
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
In the 'Activity' field, enter the ID of the activity you want to modify. This identifies the specific task that needs updating.
For the remaining steps, follow the same process outlined in "How to create an activity", updating only the necessary details instead of entering new ones.
How to create a deal in Pipedrive via ZBrain Flow
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
Fill in the required 'Title' field with the name of the deal.
Optionally, you can provide 'Creation Time' to specify when the deal was created.
Select the 'Status' of the deal if neededâOpen, won, lost, and deleted.
Choose a 'Stage' if you want to move the deal into a specific stage. If you select a stage here, the 'Pipeline' field will be ignored.
If you have not selected a 'Stage,' fill in the 'Pipeline' field.
Optionally fill in the pipeline 'Owner' if a specific owner needs to be assigned.
You can associate the deal with an 'Organization' or a 'Person' if applicable.
Assign a 'Label' if you use labels for deal categorization.
Set the 'Probability' field to define the likelihood of closing the deal.
Specify an 'Expected Close Date' in the YYYY-MM-DD format.
Enter the 'Value' of the deal.
Fill in the 'Currency' field using the appropriate currency code.
Set the âVisible Toâ field to either âItem Ownerâ or âAll Usersâ to control who can view the deal within your organization.
How to configure the update deal action in Pipedrive
Configuration steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above.
In the âDealâ field, select the specific deal you want to update.
All other fields such as âTitleâ, âCreation Timeâ, âStatusâ, âStageâ, âPipelineâ, âOwnerâ, âOrganizationâ, âPersonâ, âLabelâ, âProbabilityâ, âExpected Close Dateâ, âValueâ, âCurrencyâ, and âVisible Toâ are configured the same way as in the âCreate Dealâ setup. Please refer to the "How to create a deal in Pipedrive via ZBrain Flow" section for all these common steps. Fill these fields as needed to update the deal details.
How to configure the create lead action in Pipedrive
Before setting up the create lead action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âTitleâ field, enter the title for the lead.
From the âOwnerâ field, assign the lead to a specific user.
Enter the organization and person details in the âOrganizationâ and âPersonâ fields if needed.
Use the âLabelâ field to tag your lead appropriately.
If you want to specify when you expect to close the lead, fill the âExpected Close Dateâ field in YYYY-MM-DD format.
Set the visibility of the lead by choosing âItem Ownerâ or âAll Usersâ in the âVisible Toâ field.
In the âChannelâ field, provide the channel through which the lead was sourced.
Define the leadâs value in the âLead Valueâ field and its corresponding currency code in the âLead Value Currencyâ field.
How to configure the update lead action in Pipedrive
Before setting up the update lead action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âLeadâ field, choose the lead you want to update.
After selecting the lead, the remaining steps are the same as those explained in the âcreate leadâ configuration. Please refer to the "How to configure the create lead action in Pipedrive" section for filling fields like âTitleâ, âOwnerâ, âOrganizationâ, âPersonâ, âLabelâ, âExpected Close Dateâ, âVisible Toâ, âChannelâ, âLead Valueâ, and âLead Value Currencyâ.
How to configure the create organization action in Pipedrive
Configuration Steps:
For connecting to your Pipedrive account, follow the steps in the "How to connect to Pipedrive" section above or select an existing Pipedrive connection to authorize access.
Enter the organizationâs name in the âNameâ field. This is a required input.
Choose the organization owner from the âOwnerâ dropdown, which lists users from your Pipedrive account.
Set visibility permissions using the âVisible Toâ field to control who in your organization can view this record.
Select an appropriate category from the âLabelâ dropdown to tag the organization.
Provide the address in the âAddressâ field, if applicable.
How to configure the update organization action in Pipedrive
Before setting up the update organization action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âOrganizationâ field, select the organization you want to update.
After selecting the organization, the remaining steps are the same as those explained in the âcreate organizationâ configuration. Please refer to the "How to configure the create organization action in Pipedrive" section for filling fields like âNameâ, âOwnerâ, âVisible Toâ, âLabelâ, and âAddressâ.
How to configure the create person action in Pipedrive
Before setting up the 'Create Person' action, ensure that you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âNameâ field, enter the full name of the person you want to add.
In the âOwnerâ field, select the owner from your Pipedrive user list.
In the âOrganizationâ field, select the organization to which this person is linked.
In the âEmailâ field, click on âAdd Itemâ and enter the email address of the person. You can add multiple email addresses, if any.
In the âPhoneâ field, click on âAdd Itemâ and enter the phone number of the person. You can add multiple phone numbers, if any.
In the âLabelâ field, choose a label to categorize the person.
In the âFirst Nameâ field, you can optionally enter the personâs first name.
In the âLast Nameâ field, you can optionally enter the personâs last name.
In the âVisible Toâ field, define who in your Pipedrive account can view this person.
In the âMarketing Statusâ field, select the personâs consent status for marketing communication. The dropdown includes âno consentâ, âunsubscribedâ, âsubscribedâ, and âarchivedâ.
How to configure the update person action in Pipedrive
Before setting up the update person action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âPersonâ field, choose the person you want to update.
After selecting the person, the remaining steps are the same as those explained in the âcreate personâ configuration. Please refer to the "How to configure the create person action in Pipedrive" section for filling fields like âNameâ, âOwnerâ, âOrganizationâ, âEmailâ, âPhoneâ, âLabelâ, âFirst Nameâ, âLast Nameâ, âVisible Toâ, and âMarketing Statusâ.
How to configure the create product action in Pipedrive
Before setting up the create product action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âNameâ field, enter the name of the product you want to create.
In the âCodeâ field, enter the internal code or SKU used to identify the product.
Use the âDescriptionâ field to provide additional details about the product.
In the âUnitâ field, specify the unit of measurement for the product (e.g., piece, hour, kg).
Use the âTax percentageâ field to specify the applicable tax rate for this product.
Enable the âIs Active?â checkbox if the product should be marked as active.
In the âOwnerâ field, select a user from your Pipedrive account who will be assigned as the owner of the product.
In the âCurrencyâ field, enter the currency code in which the product is priced (e.g., USD, EUR).
Use the âPriceâ field to specify the base selling price of the product.
In the âCostâ field, enter the production or purchase cost of the product.
In the âOverhead Costâ field, enter any additional indirect costs associated with the product.
In the âVisible Toâ field, define the visibility of the product (item owner and all users).\
How to configure the find deals associated with person action in Pipedrive
Before setting up the find deals associated with person action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âPersonâ field, select the person whose associated deals you want to retrieve from your Pipedrive contact list.
This will retrieve all the deals associated with that specfic person.
How to configure the find product action in Pipedrive
Before setting up the find product action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âSearch Termâ field, enter the keyword or phrase you want to use to find the product in your Pipedrive database. This can be a part of the product name, code, or any identifying term.
How to configure the find products action in Pipedrive
Before setting up the find products action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
From âField to search byâ dropdown, select whether you want to search using the product âNameâ or âProduct Codeâ.
In the âField Valueâ field, enter the specific name or product code you want to use for the search.
How to configure the find notes action in Pipedrive
Before setting up the find notes action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âSearch Byâ field, select the type of record you want to find notes for. You can choose from âDealâ, âLeadâ, âPersonâ, or âOrganizationâ.
In the âIDâ field, enter the ID of the selected record type for which you want to retrieve notes.
How to configure the retrieve a product action in Pipedrive
Before setting up the retrieve a product action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âProduct IDâ field, enter the ID of the product you want to retrieve details for.
How to configure the find organization action in Pipedrive
Before setting up the find organization action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the "How to connect to Pipedrive" section.
Configuration steps:
In the âField to search byâ field, specify the organization field you want to search with. This could be the organization name, ID, or any other supported search field.
How to configure the find person action in Pipedrive
The configuration steps for this action are the same as those explained in the "How to configure the find organization action in Pipedrive" section. Follow the same approach to create a connection and fill the âField to search byâ to retrieve person records.
How to configure the find deal action in Pipedrive
The configuration steps for this action are the same as those explained in the "How to configure the find organization action in Pipedrive" section. Follow the same approach to create a connection and fill the âField to search byâ to retrieve a dealâs records.
How to configure the find activity action in Pipedrive
Before setting up the find activity action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the âHow to connect to Pipedriveâ section.
Configuration steps:
In the âSubjectâ field, enter the title or subject of the activity you want to search for.
Enable the âExact Matchâ option if you want to search only for activities that exactly match the subject text.
In the âAssign Toâ field, select the user the activity is assigned to.
In the âActivity Typeâ field, choose the type of activity you are looking for, such as a call, meeting, or task.
In the âFilterâ field, apply any existing filters from your Pipedrive account to narrow down the results.
In the âStatusâ field, select whether to retrieve activities marked as âDoneâ or âNot doneâ.
How to configure the find user action in Pipedrive
Before setting up the find user action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the âHow to connect to Pipedriveâ section.
Configuration steps:
From the âField to search byâ dropdown, choose the user attribute you want to search by. This could be a field like name or email.
In the âField Valueâ field, enter the value corresponding to the selected search field to locate the user.
How to configure the custom API call action in Pipedrive
Before setting up the custom API call action, make sure you have connected your Pipedrive account. To do that, follow the connection steps explained in the âHow to connect to Pipedriveâ section.
Configuration steps:
In the âURLâ field, enter the full API endpoint or the relative path. For example,
https://api.pipedrive.com/v1/deals
or/deals
.In the âMethodâ field, choose the HTTP method to be used for the API call (e.g., GET, POST, PUT, PATCH, DELETE, HEAD).
In the âHeadersâ section, click âAdd Itemâ to add any custom headers needed for the request. Authorization headers will be added automatically from your Pipedrive connection.
In the âQuery Parametersâ section, click âAdd Itemâ to specify any query parameters to be passed along with the request.
In the âBodyâ section, enter the request payload if the method requires it (e.g., POST or PUT).
Optionally, you can togggle âNo Error on Failureâ if you donât want the flow to fail when the API call fails.
In the âTimeout (in seconds)â field, set a timeout duration for the request. If left blank, the default system timeout will be used.
This setup allows you to make custom API requests to Pipedriveâs endpoints beyond the predefined actions, enabling more control and flexibility.
Last updated