Search contacts with advanced filtering
POST/v2/contacts/search
Performs advanced contact search with multiple filtering criteria, sorting options, and pagination. Supports complex queries across contact attributes, personal information, and organizational relationships.
Search Capabilities:
- Multi-field filtering (name, email, phone, company, dates, etc.)
- Flexible date range searches for creation and modification dates
- Multiple value matching (OR logic within fields)
- Custom sorting by any contact field
- Pagination with configurable page sizes
- Company relationship filtering and organizational hierarchy searches
Performance Features:
- Optimized database queries with proper indexing
- Configurable result limits to prevent large responses
- Efficient pagination for large datasets
- Cached results for frequently accessed data
- Support for complex organizational queries
Use Cases:
- Contact discovery and relationship management
- Data analysis and reporting across organizations
- Integration with external CRM/ERP systems
- Contact service lookup tools
- Organizational structure analysis and management
- Communication and marketing campaign targeting
Request
Responses
- 200
- 400
- 401
- 403
- 500
Search completed successfully with paginated results
Invalid search criteria or validation errors
Authentication required - provide valid OAuth2 token
Insufficient permissions - requires contacts:read scope
Internal server error occurred during contact search