search_contacts
Search and filter CRM contacts by name, email, phone, and custom criteria. Manage leads, assess statuses, and retrieve full contact details with expandable fields.
Instructions
Search and filter contacts in Propstack CRM.
Use this tool to:
Find contacts by name, email, or phone number
List recent leads (sort by created_at desc)
Find uncontacted leads (last_contact_at is null)
Filter by broker assignment, status, tags, or GDPR status
Search across all contact fields with 'q' parameter
The 'q' parameter searches across: first name, last name, all emails, all addresses, and all phone numbers.
Phone search ('phone_number') ignores formatting — both 015712345678 and 0157-123-456-78 will match.
Returns paginated results. Use expand=true for full details including custom fields.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Fulltext search across name, email, address, phone | |
| page | No | Page number (default: 1) | |
| No | Search by email address | ||
| group | No | Filter by tag/group IDs (Merkmale) | |
| order | No | Sort order (default: desc) | |
| owner | No | Filter for property owners | |
| expand | No | Include full details and custom fields | |
| status | No | Filter by contact status IDs | |
| sort_by | No | Field to sort results by | |
| sources | No | Filter by lead source IDs (e.g. ImmoScout24, Website) | |
| archived | No | Archive filter: '-1' = all (including archived), '1' = archived only. Omit for non-archived only (default). | |
| language | No | Filter by language codes (e.g. 'de', 'en') | |
| per_page | No | Results per page (default: 25) | |
| broker_id | No | Filter by assigned broker ID | |
| newsletter | No | Filter by newsletter opt-in | |
| gdpr_status | No | GDPR status: 0=Keine Angabe, 1=Ignoriert, 2=Zugestimmt, 3=Widerrufen | |
| project_ids | No | Filter by associated project IDs | |
| not_in_group | No | Exclude contacts with these tag/group IDs | |
| phone_number | No | Search by phone number (formatting-insensitive) | |
| created_at_to | No | Filter contacts created before this date (ISO 8601) | |
| updated_at_to | No | Filter contacts updated before this date (ISO 8601) | |
| accept_contact | No | Filter by contact permission | |
| home_countries | No | Filter by home country codes | |
| created_at_from | No | Filter contacts created after this date (ISO 8601) | |
| updated_at_from | No | Filter contacts updated after this date (ISO 8601) | |
| include_children | No | Include sub-contacts in results |