Get Deal Details (Pipedrive)
Pipedrive → Get Deal Details (Pipedrive)
/v1/pipedrive-get-deal-details{ "id": 1 }
{ "ok": true, "data": { "success": true, "id_out": 1, "title": "sample", "creator_user_id": "rec_4f3a91", "value": 1, "currency": "sample", "person_id": "rec_4f3a91", "org_id": "rec_4f3a91", "pipeline_id": "rec_4f3a91", "stage_id": "rec_4f3a91", "owner_id": "rec_4f3a91", "status": "valid", "probability": 1, "lost_reason": "sample", "visible_to": 1, "expected_close_date": "sample", "add_time": "sample", "update_time": "sample", "close_time": "sample", "won_time": "sample", "first_won_time": "sample", "lost_time": "sample", "stage_change_time": "sample", "is_deleted": true, "is_archived": true, "origin": "sample", "source_lead_id": "rec_4f3a91", "next_activity_id": "rec_4f3a91", "last_activity_id": "rec_4f3a91", "product_count": 1, "file_count": 1, "note_count": 1, "follower_count": 1, "email_message_count": "[email protected]", "activity_count": 1, "done_activity_count": 1, "undone_activity_count": 1, "participant_count": 1, "last_incoming_mail_time": "sample", "last_outgoing_mail_time": "sample", "smart_bcc_email": "[email protected]", "local_won_date": "sample", "local_lost_date": "sample", "local_close_date": "sample", "label_id_output": "sample", "custom_field_out": "sample", "origin_id": "rec_4f3a91", "channel_output": 1, "channel_id_output": "sample", "acv": 1, "arr": 1, "mrr": 1, "archive_time_output": "sample" } }
Retrieve the details of a specific deal by its ID from Pipedrive using API v2.
Install
Add get deal details (pipedrive) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__pipedrive-get-deal-details
When to use this.
The "Get Deal Details (Pipedrive)" action allows users to retrieve comprehensive information about a specific deal by its unique ID from the Pipedrive CRM platform using API v2. The primary input parameter is the deal ID (number), which identifies the deal to be fetched. Upon execution, the action returns a variety of output fields, including success status (boolean), deal title (text), deal value (number), currency (text), and key identifiers such as person ID, organization ID, and pipeline ID. Additional details include status, probability, expected close date, and various activity counts, providing a holistic view of the deal's lifecycle. This action is particularly useful for sales teams and CRM administrators looking to analyze deal performance, track progress, and manage customer relationships effectively within the CRM category.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Get Deal Details (Pipedrive)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
successSuccessnullablebooleanid_outId OutnumbertitleTitletextcreator_user_idCreator User IdnullablenumbervalueValuenumbercurrencyCurrencytextperson_idPerson Idnumberorg_idOrg Idnumberpipeline_idPipeline Idnumberstage_idStage Idnumberowner_idOwner IdnullablenumberstatusStatustextprobabilityProbabilitynullablenumberlost_reasonLost Reasonnullabletextvisible_toVisible Tonullablenumberexpected_close_dateExpected Close Datetextadd_timeAdd Timenullabletextupdate_timeUpdate Timenullabletextclose_timeClose Timenullabletextwon_timeWon Timenullabletextfirst_won_timeFirst Won Timenullabletextlost_timeLost Timenullabletextstage_change_timeStage Change Timenullabletextis_deletedIs Deletednullablebooleanis_archivedIs ArchivednullablebooleanoriginOriginnullabletextsource_lead_idSource Lead Idnullabletextnext_activity_idNext Activity Idnullablenumberlast_activity_idLast Activity Idnullablenumberproduct_countProduct Countnullablenumberfile_countFile Countnullablenumbernote_countNote Countnullablenumberfollower_countFollower Countnullablenumberemail_message_countEmail Message Countnullablenumberactivity_countActivity Countnullablenumberdone_activity_countDone Activity Countnullablenumberundone_activity_countUndone Activity Countnullablenumberparticipant_countParticipant Countnullablenumberlast_incoming_mail_timeLast Incoming Mail Timenullabletextlast_outgoing_mail_timeLast Outgoing Mail Timenullabletextsmart_bcc_emailSmart Bcc Emailnullabletextlocal_won_dateLocal Won Datenullabletextlocal_lost_dateLocal Lost Datenullabletextlocal_close_dateLocal Close Datenullabletextlabel_id_outputLabel Id Outputnullablearraycustom_field_outCustom Field Outnullableobjectorigin_idOrigin Idnullablenumberchannel_outputChannel Outputnullablenumberchannel_id_outputChannel Id OutputnullabletextacvAcvnullablenumberarrArrnullablenumbermrrMrrnullablenumberarchive_time_outputArchive Time Outputnullabletext
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/pipedrive-get-deal-details. Auth: x-api-key.
/v1/pipedrive-get-deal-detailscurl -X POST 'https://v3-api.texau.com/api/v1/pipedrive-get-deal-details' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"id":1}'
{ "ok": true, "data": { "success": true, "id_out": 1, "title": "sample", "creator_user_id": "rec_4f3a91", "value": 1, "currency": "sample", "person_id": "rec_4f3a91", "org_id": "rec_4f3a91", "pipeline_id": "rec_4f3a91", "stage_id": "rec_4f3a91", "owner_id": "rec_4f3a91", "status": "valid", "probability": 1, "lost_reason": "sample", "visible_to": 1, "expected_close_date": "sample", "add_time": "sample", "update_time": "sample", "close_time": "sample", "won_time": "sample", "first_won_time": "sample", "lost_time": "sample", "stage_change_time": "sample", "is_deleted": true, "is_archived": true, "origin": "sample", "source_lead_id": "rec_4f3a91", "next_activity_id": "rec_4f3a91", "last_activity_id": "rec_4f3a91", "product_count": 1, "file_count": 1, "note_count": 1, "follower_count": 1, "email_message_count": "[email protected]", "activity_count": 1, "done_activity_count": 1, "undone_activity_count": 1, "participant_count": 1, "last_incoming_mail_time": "sample", "last_outgoing_mail_time": "sample", "smart_bcc_email": "[email protected]", "local_won_date": "sample", "local_lost_date": "sample", "local_close_date": "sample", "label_id_output": "sample", "custom_field_out": "sample", "origin_id": "rec_4f3a91", "channel_output": 1, "channel_id_output": "sample", "acv": 1, "arr": 1, "mrr": 1, "archive_time_output": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
crm
Get Deals by Person (Pipedrive)
Retrieve all deals linked to a specified person from Pipedrive API v2, including amounts, stages, and statuses.
crm
Delete Lead (Pipedrive)
Deletes a specific lead from Pipedrive using its ID.
crm
Search Deals (Pipedrive)
Searches all deals by title, notes, and/or custom fields using Pipedrive API v2. Can be filtered by person ID, organization ID, or status.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → get deal details (pipedrive) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
Reliability
Rate limits & reliability.
- Per-minute limitNo public cap
- Per-day limitPlan-defined
- RetriesAutomatic w/ backoff
- ModeSync
Errors
HTTP status codes.
What each response means and what to do about it.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More Pipedrive actions.
crm
Get Deals by Person (Pipedrive)
Retrieve all deals linked to a specified person from Pipedrive API v2, including amounts, stages, and statuses.
crm
Delete Lead (Pipedrive)
Deletes a specific lead from Pipedrive using its ID.
crm
Search Deals (Pipedrive)
Searches all deals by title, notes, and/or custom fields using Pipedrive API v2. Can be filtered by person ID, organization ID, or status.
crm
Search Organizations (Pipedrive)
Find organizations in Pipedrive by name, address, notes, or custom fields using the v2 Search API.
FAQ.
Is this real-time?
Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).
Do I get charged on failure?
No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.
Does it work with Claude / Cursor via MCP?
Yes. Add the texau MCP server to your client config, then call `texau__pipedrive-...` directly.
What CRMs can I push results to?
HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.
Run Get Deal Details (Pipedrive) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.