How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ClickFunnels Refine Filter API

> 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).

ClickFunnels Refine Filter API is one of 102 APIs that ClickFunnels publishes on the 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.

This API exposes 5 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against a single base URL, https://{subdomain}.myclickfunnels.com/api/v2.

5 operations 2 paths 4 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://{subdomain}.myclickfunnels.com/api/v2
Authentication
HTTP Bearer
License
Terms of Service
Resource Areas
1

Authentication & Security 1

ClickFunnels Refine Filter API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

RefineFilter 5

Reusable audience filters that scope contacts for conditional splits, email broadcasts, workflow branches, and other ClickFunnels surfaces. A RefineFilter stores a named, conjunct…

GET
/workspaces/{workspace_id}/refine_filters
List Refine Filters
listWorkspaceRefineFilters 4 params → 200401404
POST
/workspaces/{workspace_id}/refine_filters
Create Refine Filter
createWorkspaceRefineFilter 1 param body → 201400401404422
GET
/refine_filters/{id}
Fetch Refine Filter
getRefineFilter 1 param → 200401404
PATCH
/refine_filters/{id}
Update Refine Filter
updateRefineFilter 1 param body → 200400401404422
DELETE
/refine_filters/{id}
Destroy Refine Filter
destroyRefineFilter 1 param → 204401404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are RefineFilterAttributes (9 properties), RefineFilterCriterion (3 properties), RefineFilterParametersCreate (1 property), RefineFilterParametersUpdate (1 property). Each schema is shown below with its type and property counts.

RefineFilterAttributes
object
A reusable workspace-scoped audience filter composed of one or more criteria joined by a single conjunction. Public API requests are validated against a [safe-…
9 properties 9 required
RefineFilterCriterion
object
A single filter criterion consisting of an attribute, a comparison clause, and a value.
3 properties
RefineFilterParametersUpdate
object
Parameters for updating an existing RefineFilter. All fields are optional — only provided fields are updated. When criteria is supplied it replaces the entire…
1 property 1 required
RefineFilterParametersCreate
object
Parameters for creating a new RefineFilter. The criteria array must contain at least one entry. Each criterion requires attribute and clause; value may be omit…
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

clickfunnels-refinefilter-api-openapi.yml Raw ↑

Other APIs ClickFunnels publishes across the network.

ClickFunnels Addresses::Country API
ClickFunnels Addresses::Region API
ClickFunnels Appointments::Scheduled Event API
ClickFunnels Blog API
ClickFunnels Blogs::Author API
ClickFunnels Blogs::Category API
ClickFunnels Blogs::Post API
ClickFunnels Blogs::Tag API
ClickFunnels Communities::Ban API
ClickFunnels Communities::Bans::Export Action API
ClickFunnels Communities::Bans::Unban Action API
ClickFunnels Communities::Membership API
Where this information came from

This is an independent, third-party profile of ClickFunnels Refine Filter API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.