deals_update
Update specific fields of existing deals in Pipedrive, such as value, title, status, or stage. Only provide the fields you want to change.
Instructions
Update an existing deal.
Updates one or more fields of an existing deal. Only provide fields you want to change.
Workflow tips:
Only specify fields you want to update
Use deals/get first to see current values
Use deals/move_to_stage for simple stage changes
To mark as won/lost, update status field
Common use cases:
Update value: { "id": 123, "value": 7500 }
Change title: { "id": 123, "title": "Updated Deal Name" }
Mark as won: { "id": 123, "status": "won" }
Update multiple fields: { "id": 123, "value": 10000, "expected_close_date": "2024-12-31", "probability": 75 }
Move to new stage: { "id": 123, "stage_id": 5 }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ID of the deal to update | |
| title | No | Deal title | |
| value | No | Deal value | |
| currency | No | 3-letter currency code | |
| user_id | No | ID of the user who will own this deal | |
| person_id | No | ID of the person | |
| org_id | No | ID of the organization | |
| pipeline_id | No | ID of the pipeline | |
| stage_id | No | ID of the stage | |
| status | No | Deal status | |
| expected_close_date | No | Expected close date in YYYY-MM-DD format | |
| probability | No | Deal success probability (0-100) | |
| lost_reason | No | Reason why the deal was lost | |
| visible_to | No | Visibility setting |