# ClickFunnels Refine Filter API

**Canonical:** https://apis.io/apis/clickfunnels/clickfunnels-refinefilter-api/  
**Provider:** ClickFunnels — https://apis.io/providers/clickfunnels/  
**Base URL:** https://{subdomain}.myclickfunnels.com/api/v2  
**Documentation:** https://developers.myclickfunnels.com/reference

ClickFunnels Refine Filter API is one of 102 APIs that [ClickFunnels](https://apis.io/providers/clickfunnels/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include RefineFilter. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and rate-limit docs.

> Reusable audience filters that scope contacts for conditional splits, email broadcasts, workflow branches, and other ClickFunnels surfaces. A RefineFilter stores a named, conjunctive set of criteria (attribute + clause + value) scoped to a workspace. Once created, pass its `id` as `condition.filter_id` on a Conditional Split Step, or as `filter_id` on any other surface that accepts one. See the [Refine Filters Skill](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md) for a full reference of supported attributes, clauses, and the safe-condition policy. The public API restricts filter conditions to a [safe whitelist](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#safe-condition-whitelist); requests outside it return 422 with a pointer to the dev community. For applying a filter to a Conditional Split Step, see [Applying filters to conditional split steps](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#applying-filters-to-conditional-split-steps). For email broadcasts, see [Applying filters to email broadcasts](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#applying-filters-to-email-broadcasts).

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/workspaces/{workspace_id}/refine_filters` | List Refine Filters |
| POST | `/workspaces/{workspace_id}/refine_filters` | Create Refine Filter |
| GET | `/refine_filters/{id}` | Fetch Refine Filter |
| PATCH | `/refine_filters/{id}` | Update Refine Filter |
| DELETE | `/refine_filters/{id}` | Destroy Refine Filter |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/clickfunnels/refs/heads/main/openapi/clickfunnels-refinefilter-api-openapi.yml
- **Documentation** — https://developers.myclickfunnels.com/docs/intro
- **APIReference** — https://developers.myclickfunnels.com/reference
- **GettingStarted** — https://developers.myclickfunnels.com/docs/getting-started
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/clickfunnels/refs/heads/main/data-model/clickfunnels-data-model.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/clickfunnels/refs/heads/main/errors/clickfunnels-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/clickfunnels/refs/heads/main/rate-limits/clickfunnels-rate-limits.yml

## Other ClickFunnels APIs (12)

- [ClickFunnels Addresses::Country API](https://apis.io/apis/clickfunnels/clickfunnels-addresses-country-api/)
- [ClickFunnels Addresses::Region API](https://apis.io/apis/clickfunnels/clickfunnels-addresses-region-api/)
- [ClickFunnels Appointments::Scheduled Event API](https://apis.io/apis/clickfunnels/clickfunnels-appointments-scheduledevent-api/)
- [ClickFunnels Blog API](https://apis.io/apis/clickfunnels/clickfunnels-blog-api/)
- [ClickFunnels Blogs::Author API](https://apis.io/apis/clickfunnels/clickfunnels-blogs-author-api/)
- [ClickFunnels Blogs::Category API](https://apis.io/apis/clickfunnels/clickfunnels-blogs-category-api/)
- [ClickFunnels Blogs::Post API](https://apis.io/apis/clickfunnels/clickfunnels-blogs-post-api/)
- [ClickFunnels Blogs::Tag API](https://apis.io/apis/clickfunnels/clickfunnels-blogs-tag-api/)
- [ClickFunnels Communities::Ban API](https://apis.io/apis/clickfunnels/clickfunnels-communities-ban-api/)
- [ClickFunnels Communities::Bans::Export Action API](https://apis.io/apis/clickfunnels/clickfunnels-communities-bans-exportaction-api/)
- [ClickFunnels Communities::Bans::Unban Action API](https://apis.io/apis/clickfunnels/clickfunnels-communities-bans-unbanaction-api/)
- [ClickFunnels Communities::Membership API](https://apis.io/apis/clickfunnels/clickfunnels-communities-membership-api/)

## Tags

RefineFilter

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/clickfunnels/clickfunnels-refinefilter-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/clickfunnels/.