Search

google_contacts.search_contacts

ActionCRM & salesconnection required

Calls the People API GET /people:searchContacts.

Search Google Contacts (People API) by name/email/phone.

Ask about Google Contacts All Google Contacts nodes

Connection

Required: Yes — the node will not save without one
Auth type: OAuth 2.0
Providers: Google Contacts
Secret shape: {"client_id", "client_secret", "refresh_token"}
Resolved by: config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
query Search text. Supports {{ }}.	string	Yes	—	—	—
page_size Max results (1-30).	number	No	10	≥ 1	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "page_size": 10
}

Output

One shape.

result

Field	Type	Example
contacts Matching contacts. Each: resource_name, display_name, email (the primary one), etag (required to update the contact), given_name, middle_name, family_name, emails[{value, type, primary}], phone, phones[{value, type, primary}], organization, job_title, notes, addresses[{formatted, type, street, city, region, postal_code, country, country_code}], urls[{value, type, primary}], photo_url, group_resource_names, updated, sources[{type, id}], deleted.	array	—
count How many contacts matched.	number	—
warmed_up True when this call primed Google's search cache and the priming landed. Google builds that cache asynchronously, so an empty result on a warmed-up search may still mean 'not indexed yet' rather than 'not there'.	boolean	—

{
  "contacts": [],
  "count": 0,
  "warmed_up": false
}

Notes

Search reads Google's contact index, which lags writes by a few seconds: an empty result right after a create means 'not indexed yet', not 'not there'. For a full sweep use google_contacts.list_contacts — search never returns more than 30.

Related Google Contacts nodes

See Search run in a workflow.

In a technical demo we add the Google Contacts connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales