Get contacts
Retrieve a paginated list of contacts.
Responses include direct Enginy app URLs when available. Each returned contact includes an appUrl field, and associated companies include appUrl when present. MCP agents should return those URLs to users whenever they are present in the response.
Required scope:
CONTACTS_READRate limit: 100 requests per minute
Authorizations
Query Parameters
Page number for pagination. Minimum value is 1. Defaults to 1.
Number of items per page. Minimum is 1, maximum is 100. Defaults to 25.
Search term to filter contacts by first name, last name, or email (case-insensitive).
Filter contacts by company ID.
Filter contacts by list ID.
Filter contacts updated on or after this date (ISO 8601 format).
Filter contacts updated on or before this date (ISO 8601 format).
Filter contacts by a specific actions run ID. Returns only contacts that were created or processed as part of this actions run (e.g., from "Search contacts from company" action).
Specific contact fields to include in the response (comma-separated or array). Use GET /v1/contacts/fields (MCP tool get_contact_field_metadata) to discover valid contact field names.