A dynamic list is a saved set of filter rules. Its membership updates automatically as contacts are added, changed, or removed in your Directory, so the list stays current without you editing it. You can build a dynamic list two ways: describe the audience in plain language and let ContactMonkey generate the rules, or add each rule by hand. Both are covered below.
Not sure which list type you need? See List Management — Static vs. Dynamic Lists: Which Should I Use?
Prerequisites
Before you begin, please ensure you have:
- Owner or Administrator permissions in ContactMonkey
- Contacts synced to your Directory via Azure AD, Workday, HRIS API, or CSV
How to Create a Dynamic List
- Click Directory at the top of the ContactMonkey dashboard.
- Click Build a list in the top right. This button is available from both the Recipients and Lists tabs.
- Enter a List name. Use something descriptive, like “Toronto Team.”
- Select a Teams value. This controls which teams can send to the list.
- In Describe who should be in the list, type who you want in plain language — for example,
everyone in Toronto. Use the suggested examples below the field if you want a starting point. - Click Create filters. ContactMonkey converts your description into rules and confirms what it understood.
- Review the Rules panel. Your description becomes a rule such as
City is any of Toronto. - Check the recipient count above the table — for example, 35 recipients will get this · of 119. This count updates as you change rules.
- Click Save list.
Your new list appears on the Lists tab with a Dynamic badge, its email and SMS recipient counts, and its assigned team.
Adjusting the Generated Rules
The description field provides a starting point you can change before saving.
- Edit rules — change the field, operator, or value in an existing rule
- Add rule — add another condition
- Clear — remove all rules and start over
🎥 Video Walkthrough
How to Add Rules Manually
Skip the description field if you’d rather build the list condition by condition.
- Click Directory at the top of the ContactMonkey dashboard.
- Click Build a list in the top right. This button is available from both the Recipients and Lists tabs.
- Enter a List name. Use something descriptive, like “Toronto Team.”
- Select a Teams value. This controls which teams can send to the list.
- In the Rules panel, click Add rule.
- Choose the field you want to filter on, such as Department or City.
- Choose an operator. The options depend on the field type — see the table below.
- Enter or select the value to match.
- Click Add rule again for each additional condition.
- Check the recipient count, then click Save list.
Operators by Field Type
| Field type | Examples | Operators available |
|---|---|---|
| Standard fields | Email Address, Employee ID | Equals, Does Not Equal, Contains, Does Not Contain |
| Data set fields | Office Location, Department | Is any of (select from dropdown) |
Data set fields are fields with a limited number of possible values, so a dropdown is faster and prevents typos. Which fields are data sets depends on your sync method — see the field tables in your sync method’s article.
Using AND/OR Logic
Combine conditions to narrow or widen your audience.
AND narrows your results
Use AND when all conditions must be true. If any condition is false, the contact is excluded, so results get smaller as you add conditions.
Example: Department = Marketing AND Country = Canada returns only contacts who are in Marketing and located in Canada. A Marketing contact in the US is excluded. A Canadian contact in Sales is excluded.
OR widens your results
Use OR when at least one condition must be true. If any condition is true, the contact is included, so results get larger as you add conditions.
Example: Department = Marketing OR Department = Sales returns contacts in Marketing, contacts in Sales, and contacts in both. A contact in Engineering is excluded.
Understanding Rules and Rulesets
A rule is a single condition, such as Country = Canada.
A ruleset is a group of rules combined with the same logic type, such as (Country = Canada AND Department = Engineering).
You can mix AND and OR as much as you want within a single ruleset.
Example: Combining AND and OR
Ruleset 1: (Country = Canada AND Department = Engineering)
OR
Ruleset 2: (Job Title contains Executive OR City = Toronto)
This finds contacts who are either in Canada and in Engineering, or who have “Executive” in their title or are in Toronto.
Included: a Canadian engineer (Ruleset 1). An Executive Director in the US (Ruleset 2). A Toronto salesperson (Ruleset 2).
Excluded: a Canadian salesperson — matches neither ruleset completely. A US engineer — same.
How to Filter the Recipients Table
Filtering the Recipients table is a separate feature from building a list. Use it to check your Directory data before you commit to rules.
- Click Directory at the top of the ContactMonkey dashboard
- Use the filter row directly below the column headers. Text fields accept free text, data set fields open a checkbox dropdown with a search box, and date fields open a date picker.
- Watch the row count at the bottom of the table to see how many contacts match.
Filtering the Recipients table does not create a list. To save an audience, click Build a list.

Troubleshooting
The rules don’t match what I described.
The description field generates a best guess. Click Edit rules and adjust the field, operator, or value directly.
I get a “something went wrong” error.
Too many conditions stacked in a single rule can trigger this. Split your conditions across multiple rulesets.
My recipient count is 0.
Check that your rule values match your Directory data exactly. A rule for City is any of Toronto won’t match contacts stored as “Toronto, ON.”
Tips for Effective Filtering
- Start simple. Begin with one or two conditions, then add complexity.
- Check the count before you save. The live recipient count is your preview.
- Use data sets where available. Dropdown selection prevents typos.
- Name lists descriptively. “Canada Engineering Team” beats “List 1.”
- Export before a big change. Click Export CSV to keep a record of the current members.