Precise Job Title Matching Controls
- Removed
is_job_title_strictfilter. - Added
job_title_match_modeandjob_title_smart_modefilters to replace the strict/loose boolean with more granular control over job title matching.
Migration Guide
The boolean is_job_title_strict filter has been replaced by two new parameters that offer finer-grained control over how job title searches are matched.
| Old | New |
|---|---|
is_job_title_strict: true | job_title_match_mode: "exact" |
is_job_title_strict: false | job_title_match_mode: "smart" with job_title_smart_mode: "normal" |
If you were not using is_job_title_strict at all (relying on default behavior), no action is required — the new default (job_title_match_mode: "contains") preserves substring-based matching.
job_title_match_mode
job_title_match_modeDetermines how job title filters are matched against lead records.
| Value | Description |
|---|---|
exact | Only returns leads whose job title exactly matches your entered titles. e.g. "Marketing Manager" matches only "Marketing Manager". |
contains | Returns leads whose job title contains your search terms. e.g. "Manager" matches "Marketing Manager", "Sales Manager". |
smart | Uses intelligent matching to find related and similar job titles. e.g. "CTO" may also match "Chief Technology Officer". |
Default: contains
job_title_smart_mode
job_title_smart_modeControls the sensitivity of smart job title matching.
Only applies whenjob_title_match_modeis set tosmart. This parameter is ignored forexactandcontainsmodes.
| Value | Description |
|---|---|
loose | Widest smart matching with more flexible results. e.g. "Engineer" may match "Software Developer", "DevOps Engineer". |
normal | Balanced smart matching suitable for most searches. e.g. "Product Manager" matches closely related product roles. |
strict | Tighter smart matching with fewer, more precise results. e.g. "VP Sales" matches only very close sales leadership titles. |
Default: normal
Why this change?
The previous is_job_title_strict boolean only supported two states (strict exact-match vs. loose smart-match), which didn't give users control over substring matching or the aggressiveness of smart matching. The new two-parameter model separates matching strategy (job_title_match_mode) from matching sensitivity (job_title_smart_mode), allowing more precise filtering across a wider range of use cases.