Pipedrive logo

Search Deals (Pipedrive)

Pipedrive → Search Deals (Pipedrive)

POST/v1/pipedrive-search-deals
texau__pipedrive-search-dealscrm
Run in Studio →Open in MCP
cURL · api.texau.app
84ms
POST/v1/pipedrive-search-deals
{
  "term": "sample-value",
  "field": "sample-value",
  "exact_match": "sample-value",
  "person_id": 1,
  "organization_id": "Acme, Inc.",
  "status": "sample-value",
  "limit": 1
}
200 Accepted
{
  "ok": true,
  "data": {
    "success": true,
    "result_score": 92,
    "id": "rec_4f3a91",
    "type": "sample",
    "title": "sample",
    "value": 1,
    "currency": "sample",
    "status_out": "valid",
    "visible_to": 1,
    "owner_id": "rec_4f3a91",
    "stage_id": "rec_4f3a91",
    "stage_name": "sample",
    "pipeline_id": "rec_4f3a91",
    "person_id_out": 1,
    "person_name": "sample",
    "organization_id_out": 1,
    "organization_name": "sample",
    "organization_address": "sample",
    "is_archived": true,
    "cc_email": "[email protected]"
  }
}

Searches all deals by title, notes, and/or custom fields using Pipedrive API v2

Install

Add search deals (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.

claude_desktop_config.json
{
  "mcpServers": {
    "texau": {
      "command": "npx",
      "args": ["-y", "@texau/mcp-server"],
      "env": { "TEXAU_API_KEY": "..." }
    }
  }
}

Tool name: texau__pipedrive-search-deals

When to use this.

The "Search Deals (Pipedrive)" action enables users to efficiently search for deals within the Pipedrive CRM by utilizing the Pipedrive API v2. This action allows for searches based on various criteria, including deal title, notes, and custom fields, with the option to filter results by person ID, organization ID, or deal status. Key input parameters include the search term (minimum 2 characters), optional fields for specific searches, and filters for person ID, organization ID, and deal status. The action returns comprehensive output data, such as deal ID, title, value, currency, status, and associated person and organization details, ensuring users have access to relevant information. Use cases include sales tracking, deal management, and customer relationship optimization, making this action essential for businesses looking to streamline their CRM processes.

Try it

Run a sample request.

The response is a deterministic, cached example. No live call, no credits used.

Search Deals (Pipedrive)

Try it

The search term to look for. Minimum 2 characters (or 1 if using exact_match).

Select the fields to perform the search from. Defaults to all.

When enabled, only full exact matches against the given term are returned. Not case sensitive.

Filter deals by the provided person ID

Filter deals by the provided organization ID

Filter deals by a specific status.

Response is cached — no live API call.

Response

Output schema.

Every field returned in `data`. Click rows to expand nested objects.

FieldType
  • success
    Success
    nullableboolean
  • result_score
    Result Score
    nullablenumber
  • id
    Id
    number
  • type
    Type
    nullabletext
  • title
    Title
    text
  • value
    Value
    number
  • currency
    Currency
    text
  • status_out
    Status Out
    nullabletext
  • visible_to
    Visible To
    nullablenumber
  • owner_id
    Owner Id
    nullablenumber
  • stage_id
    Stage Id
    number
  • stage_name
    Stage Name
    nullabletext
  • pipeline_id
    Pipeline Id
    number
  • person_id_out
    Person Id Out
    nullablenumber
  • person_name
    Person Name
    text
  • organization_id_out
    Organization Id Out
    nullablenumber
  • organization_name
    Organization Name
    text
  • organization_address
    Organization Address
    nullabletext
  • is_archived
    Is Archived
    nullableboolean
  • cc_email
    Cc Email
    nullabletext

Integrate

Copy-pasteable snippets.

Real endpoint: https://v3-api.texau.com/api/v1/pipedrive-search-deals. Auth: x-api-key.

cURL · api.texau.app
84ms
POST/v1/pipedrive-search-deals
curl -X POST 'https://v3-api.texau.com/api/v1/pipedrive-search-deals' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"term":"sample-value","field":"sample-value","exact_match":"sample-value","person_id":1,"organization_id":"Acme, Inc.","status":"sample-value","limit":1}'
200 Accepted
{
  "ok": true,
  "data": {
    "success": true,
    "result_score": 92,
    "id": "rec_4f3a91",
    "type": "sample",
    "title": "sample",
    "value": 1,
    "currency": "sample",
    "status_out": "valid",
    "visible_to": 1,
    "owner_id": "rec_4f3a91",
    "stage_id": "rec_4f3a91",
    "stage_name": "sample",
    "pipeline_id": "rec_4f3a91",
    "person_id_out": 1,
    "person_name": "sample",
    "organization_id_out": 1,
    "organization_name": "sample",
    "organization_address": "sample",
    "is_archived": true,
    "cc_email": "[email protected]"
  }
}

Compose

How this fits a workflow.

The next 2 actions most operators chain after this one.

Search Deals (Pipedrive)→Get Deals by Person (Pipedrive)→Delete Lead (Pipedrive)

Output

Results land in a TexAu table.

Sample rows below.

Real result preview coming soon.

InputStatusScore
[email protected]valid96
[email protected]risky54
[email protected]invalid12

Workflow

A real example.

Trigger → search deals (pipedrive) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2Search Deals (Pipedrive)Pipedrive action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.

Built for

Who runs this.

GTM EngineerRevOpsAgency

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.

CodeCauseFix
200 OKAction ran. Data in `data`.Read response.
400 Bad RequestMissing or malformed input.Validate against the input schema.
401 UnauthorizedMissing or invalid `x-api-key`.Re-issue from /api-platform.
403 ForbiddenWorkspace lacks plan tier.Upgrade or contact sales.
404 Not FoundAction key not recognized.Verify the slug.
429 Rate LimitedPer-minute or per-day cap hit.Backoff; reduce concurrency.
500 Server ErrorUnexpected TexAu issue.Retry with backoff.
502 Bad GatewayUpstream provider 5xx.Retry; we surface root cause.
504 TimeoutUpstream slower than maxLatency.Switch to `isAsync` polling.

Pricing

What it costs to run.

Light tier

Pricing tier on /pricing. Per-action credit cost is private.

Related

More Pipedrive actions.

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 Search Deals (Pipedrive) in 60 seconds.

Pull your API key, paste the cURL, ship to your CRM.

Start free →Read the API docs