search_persons
Search persons in Pipedrive using name, email, phone, or organization ID, with options for exact match and field-specific filtering.
Instructions
Search for persons with advanced filtering options.
Performs a person-specific search with additional filtering by organization.
Workflow tips:
Search term must be at least 2 characters
Filter by org_id to find persons in specific organizations
Specify fields to search: name, email, phone, custom fields
Use include_fields to limit response data
Use exact_match for precise searches
Results ordered by relevance
Common use cases:
Search by name: { "term": "john smith" }
Search by email: { "term": "john@example.com", "fields": "email" }
Search in organization: { "term": "smith", "org_id": 123 }
Search phone numbers: { "term": "+1234567890", "fields": "phone" }
Limit response: { "term": "john", "include_fields": "name,email,phone" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | Yes | Search term (min 2 chars) | |
| limit | No | Number of items to return | |
| start | No | Pagination start | |
| fields | No | Comma-separated field names to search | |
| org_id | No | Filter by associated organization ID | |
| exact_match | No | Perform exact match search | |
| include_fields | No | Comma-separated fields to include in response |