BETA — RefineFilters are currently in beta. You can request access via the Funnel Coders community but keep in mind that BETA endpoints are subject to change.
Parameters for creating a new RefineFilter. The criteria array must contain at least one entry.
Each criterion requires attribute and clause; value may be omitted for set/not-set clauses.
The public API restricts criteria to the safe whitelist below. Requests
outside this set return 422 with a pointer to the dev community for
new-condition requests.
| Condition | Allowed clauses | Notes |
|---|
email_address, first_name, last_name | eq, sw | Text — equals & starts_with only. |
anonymous | eq, dne | Boolean-style option. |
created_at, unsubscribed_at, last_activity | All standard date clauses | Indexed datetime columns. |
tags.id | eq, dne, in, nin | Tag membership — must reference workspace-owned tag ids. |
has_affiliate_attribution, has_active_affiliate_attribution, referred_by_affiliate | All standard clauses | Affiliate attribution lookups. |
email_suppression | st, nst, eq, in | Email suppression set/not-set or membership. |
received_broadcast, opened_broadcast, clicked_broadcast | eq, in | Must include a specific broadcast id. |
opted_in_funnel_step, opted_in_funnel_at, opted_in_on_standalone_page | eq, in | Must include a specific funnel/step/page id. |
Conjunction is restricted to and. See the full reference at the
Refine Filters Skill.
