Actions44
- Appointment Actions
- Calendar Actions
- Contact Actions
- Custom Field Actions
- Custom Value Actions
- Email Campaign Actions
- Email Stats Actions
- Email Template Actions
- Invoice Actions
- Note Actions
- Opportunity Actions
- Pipeline Actions
- Tag Actions
- User Actions
- Workflow Actions
Contact → Find
AI-generatedSummary
Searches contacts in the selected Boomerang location by email, phone, name, or a legacy free-text query. Dedicated fields are searched separately and their results are merged and deduplicated; set the output mode to choose between one item per contact and a single item containing the results array.
Inputs
- Location (required) — Select the sub-account/location to search.
- Email — Search by exact email match.
- Phone — Search by phone; E.164 format is preferred.
- Name — Search by name. The operation uses structured first- and last-name matching.
- Query (legacy free-text) — Search across email, phone, or name. Used only when Email, Phone, and Name are all blank.
- Return All — Choose whether to return all matches or apply a result limit. Defaults to false.
- Limit — Maximum results when Return All is false. Defaults to 20; allowed range is 1–100.
- Output Mode — Return each contact as its own item (default), or return one item with a contacts array and count.
Output shape
A list of matched contact records, or one envelope item containing { contacts: [...], count: N }, depending on Output Mode.
At least one search field must be provided; an empty search throws an error. Results from the dedicated fields are merged and deduplicated by contact ID. If one lookup fails but another succeeds, successful results are retained; an error is surfaced if all lookups fail.