Reference · Tools
Pipedrive Trigger
Starts workflow when Pipedrive CRM events occur
The Pipedrive Trigger fires when CRM events occur, filtered by action — create, change, delete or all — and by entity type such as deal, person or organization. A typical build is alerting a channel whenever a deal moves into the won stage.
- Node type
- Webhook trigger
- Parameters
- 5
- Outputs
- Output
- Credentials
- Pipedrive API
Pipedrive Trigger
Trigger workflows from Pipedrive CRM events
Overview
Triggers a workflow when events happen in Pipedrive CRM. Supports filtering by action type (create, change, delete, or all) and entity type (deal, person, organization, activity, note, pipeline, product, stage, user, activity type, or all). Pipedrive sends webhook POST requests when the configured event occurs on the specified entity. Optionally supports HTTP Basic Auth for incoming webhook verification.
Category: Sales
Tool Name: pipedrive_trigger
Version: 1
Appearance: Icon: lucide-CircleDollarSign | Color: #017737
Node Type
Trigger — webhook (receives incoming HTTP callbacks)
Input / Output
| Direction | Port(s) |
|---|---|
| Input | None (trigger node) |
| Output | Output |
Credentials
This tool requires Pipedrive API credentials. See the Credentials Guide for setup instructions.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| Action | options | No | * | Type of action to receive notifications about. |
Options: * (All), create, change, delete | ||||
| Entity | options | No | * | Type of entity (object) to receive notifications about. |
Options: activity, activityType, * (All), deal, note, organization, person, pipeline, product, stage, user | ||||
| Incoming Authentication | options | No | none | If authentication should be activated for the incoming webhook (makes it more secure). When Basic Auth is selected, Pipedrive will send the configured credentials with each webhook request. |
Options: basicAuth, none | ||||
| Basic Auth Username | string | No | — | Username for HTTP Basic Auth on the incoming webhook. (shown when Incoming Authentication is basicAuth) |
| Basic Auth Password | string | No | — | Password for HTTP Basic Auth on the incoming webhook. (shown when Incoming Authentication is basicAuth) |
Output Data
Each Pipedrive notification produces one output item:
_trigger— alwayspipedrive_webhook_timestamp— ISO 8601 timestamp of when the request arrived_webhookEvent— the event as{entity}.{action}, for exampledeal.create; either half readsunknownwhen Pipedrive omits it
The Pipedrive payload is merged in at the top level, so the delivery’s meta block (action, object, record id, user and company ids, timestamp) and its current and previous record snapshots sit directly on the item. Reference them downstream by expression, e.g. {{ $json.current.title }} or {{ $json.meta.action }}. When Incoming Authentication is set to basicAuth, requests that fail the check are rejected and never reach the workflow.
Usage Examples
- Trigger workflow when a new deal is created in Pipedrive
- Start automation when a person is updated in Pipedrive
- Listen for deleted organizations in Pipedrive CRM
- Monitor all changes to deals, persons, and activities in Pipedrive
Example Configuration
Fire when a deal is created:
{
"id": "pipedrive-trigger",
"type": "pipedrive_trigger",
"position": [250, 300],
"parameters": {
"entity": "deal",
"action": "create",
"incomingAuthentication": "none"
}
}
Listen to every action on every entity:
{
"id": "pipedrive-all-events",
"type": "pipedrive_trigger",
"position": [250, 300],
"parameters": {
"entity": "*",
"action": "*",
"incomingAuthentication": "none"
}
}
Track person changes behind Basic Auth:
{
"id": "pipedrive-secure-trigger",
"type": "pipedrive_trigger",
"position": [250, 300],
"parameters": {
"entity": "person",
"action": "change",
"incomingAuthentication": "basicAuth",
"httpAuthUser": "webhook_user",
"httpAuthPassword": "a-long-random-secret"
}
}
Watch organization updates only:
{
"id": "pipedrive-org-updates",
"type": "pipedrive_trigger",
"position": [250, 300],
"parameters": {
"entity": "organization",
"action": "change",
"incomingAuthentication": "none"
}
}
Monitor every activity event:
{
"id": "activity-monitor",
"type": "pipedrive_trigger",
"position": [250, 300],
"parameters": {
"entity": "activity",
"action": "*",
"incomingAuthentication": "none"
}
}
Trigger Behavior
- Activation: When the workflow is activated, a webhook endpoint is registered with the service.
- Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
- Payload: The incoming webhook payload is parsed and output as workflow items.
- Verification: Supports signature verification where applicable.
Tips
Listens for Pipedrive CRM events. Select the action (create, change, delete, or all) and entity type (deal, person, organization, etc.) to filter which events trigger the workflow. Pipedrive will send a POST request to the webhook URL whenever matching events occur.
Important Notes
- The trigger creates a webhook URL that must be registered in your Pipedrive account
- When using Basic Auth, ensure credentials are stored securely and match what’s configured in Pipedrive
- The
"*"wildcard values allow monitoring of all entities or all actions, but may result in high webhook volume - Webhook payloads will contain the full object data from Pipedrive for the triggered event
Frequently asked questions
Do I need to register the webhook?
Yes — the trigger creates a webhook URL that must be registered in your Pipedrive account for events to be delivered.
How do I narrow which events fire it?
By action and entity type. Selecting `change` on `deal` only wakes the workflow for deal modifications rather than every CRM event.
What should I know about Basic Auth?
If you use it, the credentials must be stored securely and must match exactly what is configured in Pipedrive, or deliveries are rejected.
Which credential does it need?
A Pipedrive API credential, the same one the action node uses.
Build with the Pipedrive Trigger node
Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Pipedrive API credentials first.
Open BusyBotLast updated . Spotted something wrong? Tell us.