Pipedrive logo

Search All Persons (Pipedrive)

Pipedrive → Search All Persons (Pipedrive)

POST/v1/pipedrive-search-persons
texau__pipedrive-search-personscrm
Run in Studio →Open in MCP
cURL · api.texau.app
84ms
POST/v1/pipedrive-search-persons
{
  "term": "sample-value",
  "field": "sample-value",
  "exact_match": true,
  "organization_id": "Acme, Inc.",
  "limit": 1
}
200 Accepted
{
  "ok": true,
  "data": {
    "result_score": 92,
    "id": "rec_4f3a91",
    "type": "sample",
    "unique_name": "sample",
    "primary_email": "[email protected]",
    "email": "[email protected]",
    "mobile_number": "sample",
    "visible_to": 1,
    "owner_id": "rec_4f3a91",
    "organization_id": "rec_4f3a91",
    "organization_name": "sample",
    "organization_address": "sample",
    "custom_fields": "sample",
    "note": "sample",
    "open_deal_count": 1,
    "picture": "sample",
    "update_time": "sample"
  }
}

Find persons in Pipedrive by name, email, phone, notes, or custom fields using the v2 Search API.

Install

Add search all persons (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-persons

When to use this.

The "Search All Persons (Pipedrive)" action enables users to efficiently locate individuals within the Pipedrive CRM by utilizing various search criteria such as name, email, phone number, notes, or custom fields through the v2 Search API. Key input parameters include the search term (minimum of 2 characters), optional fields for targeted searches, an exact match boolean for precise results, an organization ID to filter by specific organizations, and a limit on the number of results displayed per page. The output provides comprehensive details, including result scores, person IDs, names, primary emails, phone numbers, organization details, custom fields, and notes. This action is particularly useful for sales teams and customer relationship managers seeking to streamline their contact management processes, enhance lead tracking, and improve customer interactions within the CRM category.

Try it

Run a sample request.

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

Search All Persons (Pipedrive)

Try it

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

Select a specific field to search within. Leave empty to search across all fields.

When set to true, only exact matches against the given term are returned (Not case sensitive).

If supplied, only persons from the given organization ID will be returned.

Items shown per page

Response is cached — no live API call.

Response

Output schema.

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

FieldType
  • result_score
    Result Score
    number
  • id
    Id
    number
  • type
    Type
    nullabletext
  • unique_name
    Unique Name
    nullabletext
  • primary_email
    Primary Email
    text
  • email
    Email
    nullabletext
  • mobile_number
    Mobile Number
    nullabletext
  • visible_to
    Visible To
    nullablenumber
  • owner_id
    Owner Id
    nullablenumber
  • organization_id
    Organization Id
    nullablenumber
  • organization_name
    Organization Name
    nullabletext
  • organization_address
    Organization Address
    nullabletext
  • custom_fields
    Custom Fields
    nullabletext
  • note
    Note
    nullabletext
  • open_deal_count
    Open Deal Count
    nullablenumber
  • picture
    Picture
    nullabletext
  • update_time
    Update Time
    nullabletext

Integrate

Copy-pasteable snippets.

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

cURL · api.texau.app
84ms
POST/v1/pipedrive-search-persons
curl -X POST 'https://v3-api.texau.com/api/v1/pipedrive-search-persons' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"term":"sample-value","field":"sample-value","exact_match":true,"organization_id":"Acme, Inc.","limit":1}'
200 Accepted
{
  "ok": true,
  "data": {
    "result_score": 92,
    "id": "rec_4f3a91",
    "type": "sample",
    "unique_name": "sample",
    "primary_email": "[email protected]",
    "email": "[email protected]",
    "mobile_number": "sample",
    "visible_to": 1,
    "owner_id": "rec_4f3a91",
    "organization_id": "rec_4f3a91",
    "organization_name": "sample",
    "organization_address": "sample",
    "custom_fields": "sample",
    "note": "sample",
    "open_deal_count": 1,
    "picture": "sample",
    "update_time": "sample"
  }
}

Compose

How this fits a workflow.

The next 2 actions most operators chain after this one.

Search All Persons (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 all persons (pipedrive) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2Search All Persons (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 All Persons (Pipedrive) in 60 seconds.

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

Start free →Read the API docs