Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/clickfunnels-contact-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: ClickFunnels Contact API
termsOfService: https://www.clickfunnels.com/terms-of-service
contact:
name: ClickFunnels API Team
url: https://developers.myclickfunnels.com
x-logo:
url: https://statics.myclickfunnels.com/image/1126065/file/31edf05760fafe41a82f16a668ab251f.png
description: 'The ClickFunnels REST API that powers webhooks, native integrations, and Zapier lets you manage your ClickFunnels data, automate your workflows, and recreate ClickFunnels functionality in your own apps.
'
license:
name: MIT
url: https://opensource.org/licenses/MIT
version: 2.0.0
servers:
- url: https://{subdomain}.myclickfunnels.com/api/v2
description: ClickFunnels API
variables:
subdomain:
default: myworkspace
security:
- BearerAuth: []
tags:
- name: Contact
description: Contact
paths:
/workspaces/{workspace_id}/contacts:
get:
tags:
- Contact
summary: List Contacts
description: List contacts for the given workspace. By default, only identified contacts are shown so you won't see anonymous or GDPR-redacted contacts.
operationId: listContacts
parameters:
- name: workspace_id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/after'
- $ref: '#/components/parameters/sort_order'
- $ref: '#/components/parameters/sort_property'
- name: filter
in: query
description: 'Filter by available properties in query params, like this: `api/v2/resources?filter[id]=value&filter[another_property]=value1,value2`. Check our Filtering guide for examples and all about filtering [here](https://developers.myclickfunnels.com/docs/filtering).
'
required: false
schema:
type: object
properties:
email_address:
type: string
description: A comma-separated list of email addresses to filter by.
example: russel@clickfunnels.com,todd@clickfunnels.com
id:
type: string
description: A comma-separated list of contact IDs to filter by.
example: 1,42
tag_ids:
type: string
description: A comma-separated list of Contacts::Tag IDs to filter contacts that had those tags applied to them.
example: 1,42
is_active:
type: boolean
description: Filter contacts by their active status. Pass true to return only active contacts, or false to return only inactive contacts.
example: true
style: deepObject
explode: true
- name: stored_filter_id
in: query
required: false
schema:
type: string
description: 'The `id` (integer) or `public_id` (string) of a saved `Refine::StoredFilter` scoped to this workspace. Returned by `POST /api/v2/workspaces/{workspace_id}/contacts/filters` (with `save: true`) or by the RefineFilter endpoints. Applies the saved filter''s criteria to the results, composed (AND) with any `filter[…]` params.
Returns 422 if the filter is unknown, invalid, or belongs to a different workspace. When both `stored_filter_id` and `stable_id` are supplied, `stable_id` takes precedence.'
- name: stable_id
in: query
required: false
schema:
type: string
description: 'A URL-encoded Refine `stable_id` token — the standard gzip+base64 full-state format used by both the contacts/filters API endpoint and the server-rendered filter UI, making the tokens interoperable. Returned by `POST /api/v2/workspaces/{workspace_id}/contacts/filters` in the `stable_id` field. Treat the returned token as opaque and let the HTTP client encode the complete query parameter value. With curl, use `-G --data-urlencode "stable_id=$STABLE_ID"`; do not decode the token or interpolate it directly into a raw URL. Applies the encoded filter criteria to the results, composed (AND) with any `filter[…]` params.
Returns 422 if the token is not a valid Refine stable_id, is not a ContactsFilter, or groups conditions with mixed `and`/`or` semantics. Flat filters and grouped filters using a single conjunction (including tokens copied from the filtered Contacts UI) are supported. When both `stored_filter_id` and `stable_id` are supplied, `stable_id` takes precedence.'
- $ref: '#/components/parameters/ExpandContactFields'
responses:
'200':
description: OK
headers:
Pagination-Next:
$ref: '#/components/headers/PaginationNext'
Link:
$ref: '#/components/headers/Link'
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ContactAttributes'
example:
- id: 24359
public_id: vQxYMj
workspace_id: 4
anonymous: 0
email_address: jane.doe@example.com
first_name: Jane
last_name: Doe
phone_number: '+18005550199'
time_zone: Madrid
uuid: 80b7f903-76cd-4edf-94bf-fc34c13ee654
unsubscribed_at: null
last_notification_email_sent_at: null
email_suppression_reason: null
is_active: true
fb_url: null
twitter_url: null
instagram_url: null
linkedin_url: null
website_url: null
created_at: '2026-01-09T15:27:56.647Z'
updated_at: '2026-01-09T15:28:08.075Z'
tags: []
custom_attributes: {}
visits:
first_visit:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
last_visit: null
last_visit_with_utm:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: API key missing or invalid
'404':
description: Not Found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Not found - This usually happens when you try to access a record that does not exist in your account. It can also happen when the provided parent record is missing, e.g. you have put in a non-existent Workspaces parent ID.
example:
error: 'Not found: Record missing'
'422':
description: Unprocessable Entity — `stored_filter_id` is unknown, invalid, or belongs to a different workspace; or `stable_id` is not a valid Refine token, is not a ContactsFilter, or groups conditions with mixed `and`/`or` semantics. Flat and single-conjunction grouped stable-id filters are supported.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: stored_filter_id is invalid or does not belong to this workspace
post:
tags:
- Contact
summary: Create Contact
description: Add a new contact to the workspace
operationId: createContacts
parameters:
- name: workspace_id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/ExpandContactFields'
requestBody:
description: Information about a new Contact
required: true
content:
application/json:
schema:
type: object
properties:
contact:
type: object
$ref: '#/components/schemas/ContactParameters'
example:
contact:
email_address: test-4059727ec8e173ce4648@example.com
first_name: Sol
last_name: Jones
phone_number: (224) 508-1342 x59891
time_zone: Pacific Time (US & Canada)
fb_url: https://www.facebook.com/example
twitter_url: https://twitter.com/example
instagram_url: null
linkedin_url: https://www.linkedin.com/in/example
website_url: https://example.com
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAttributes'
example:
id: 24359
public_id: vQxYMj
workspace_id: 4
anonymous: 0
email_address: jane.doe@example.com
first_name: Jane
last_name: Doe
phone_number: '+18005550199'
time_zone: Madrid
uuid: 80b7f903-76cd-4edf-94bf-fc34c13ee654
unsubscribed_at: null
last_notification_email_sent_at: null
email_suppression_reason: null
is_active: true
fb_url: null
twitter_url: null
instagram_url: null
linkedin_url: null
website_url: null
created_at: '2026-01-09T15:27:56.647Z'
updated_at: '2026-01-09T15:28:08.075Z'
tags: []
custom_attributes: {}
visits:
first_visit:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
last_visit: null
last_visit_with_utm:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: 'Bad request: HTTP body must be valid JSON'
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: API key missing or invalid
/contacts/{id}:
get:
tags:
- Contact
summary: Fetch Contact
description: Retrieve a contact
operationId: getContacts
parameters:
- $ref: '#/components/parameters/id'
- $ref: '#/components/parameters/ExpandContactFields'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAttributes'
example:
id: 24359
public_id: vQxYMj
workspace_id: 4
anonymous: 0
email_address: jane.doe@example.com
first_name: Jane
last_name: Doe
phone_number: '+18005550199'
time_zone: Madrid
uuid: 80b7f903-76cd-4edf-94bf-fc34c13ee654
unsubscribed_at: null
last_notification_email_sent_at: null
email_suppression_reason: null
is_active: true
fb_url: null
twitter_url: null
instagram_url: null
linkedin_url: null
website_url: null
created_at: '2026-01-09T15:27:56.647Z'
updated_at: '2026-01-09T15:28:08.075Z'
tags: []
custom_attributes: {}
visits:
first_visit:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
last_visit: null
last_visit_with_utm:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: API key missing or invalid
'404':
description: Not Found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: 'Not found: Record missing'
put:
tags:
- Contact
summary: Update Contact
description: Update a contact
operationId: updateContacts
parameters:
- $ref: '#/components/parameters/id'
- $ref: '#/components/parameters/ExpandContactFields'
requestBody:
description: Information about updated fields in Contact
required: true
content:
application/json:
schema:
type: object
properties:
contact:
type: object
$ref: '#/components/schemas/ContactParametersUpdate'
example:
contact:
email_address: test-4059727ec8e173ce4648@example.com
first_name: Sol
last_name: Jones
phone_number: (224) 508-1342 x59891
time_zone: Pacific Time (US & Canada)
fb_url: https://www.facebook.com/example
twitter_url: https://twitter.com/example
instagram_url: null
linkedin_url: https://www.linkedin.com/in/example
website_url: https://example.com
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAttributes'
example:
id: 24359
public_id: vQxYMj
workspace_id: 4
anonymous: 0
email_address: jane.doe@example.com
first_name: Jane
last_name: Doe
phone_number: '+18005550199'
time_zone: Madrid
uuid: 80b7f903-76cd-4edf-94bf-fc34c13ee654
unsubscribed_at: null
last_notification_email_sent_at: null
email_suppression_reason: null
is_active: true
fb_url: null
twitter_url: null
instagram_url: null
linkedin_url: null
website_url: null
created_at: '2026-01-09T15:27:56.647Z'
updated_at: '2026-01-09T15:28:08.075Z'
tags: []
custom_attributes: {}
visits:
first_visit:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
last_visit: null
last_visit_with_utm:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: 'Bad request: HTTP body must be valid JSON'
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: API key missing or invalid
'404':
description: Not Found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: 'Not found: Record missing'
delete:
tags:
- Contact
summary: Remove Contact
description: Delete a contact
operationId: removeContacts
parameters:
- $ref: '#/components/parameters/id'
responses:
'204':
description: No Content
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: API key missing or invalid
'404':
description: Not Found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: 'Not found: Record missing'
/contacts/{id}/gdpr_destroy:
delete:
tags:
- Contact
summary: Redact Contact
description: This will destroy all personally identifiable information for a contact, including their name and phone number, but does not delete the contact record itself. This cannot be undone.
operationId: gdpr_destroyContacts
parameters:
- $ref: '#/components/parameters/id'
responses:
'200':
description: OK
'404':
description: Not Found
/workspaces/{workspace_id}/contacts/upsert:
post:
tags:
- Contact
summary: Upsert a Contact
description: Creates or updates a Contact, matching on the email address. If the Contact does not exist, it will be created. If the Contact does exist, it will be updated. It is not possible to delete a Contact via this endpoint. It is not possible to reset properties of a Contact by passing empty values. E.g. passing `null` for `first_name` or an empty array for `tag_ids` won't update previous values. To do that you would instead need to use the `Update Contact` endpoint.
operationId: upsertContacts
parameters:
- name: workspace_id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/ExpandContactFields'
requestBody:
description: Contact to create or update, matching on the email address. Note that properties of a Contact are not reset when passed empty values, e.g. passing `null` for `first_name` or an empty array for `tag_ids` won't update previous values. To do that you would instead use the `Update Contact` endpoint.
required: true
content:
application/json:
schema:
type: object
properties:
contact:
type: object
$ref: '#/components/schemas/ContactParameters'
example:
contact:
email_address: test-4059727ec8e173ce4648@example.com
first_name: Sol
last_name: Jones
phone_number: (224) 508-1342 x59891
time_zone: Pacific Time (US & Canada)
fb_url: https://www.facebook.com/example
twitter_url: https://twitter.com/example
instagram_url: null
linkedin_url: https://www.linkedin.com/in/example
website_url: https://example.com
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAttributes'
example:
id: 24359
public_id: vQxYMj
workspace_id: 4
anonymous: 0
email_address: jane.doe@example.com
first_name: Jane
last_name: Doe
phone_number: '+18005550199'
time_zone: Madrid
uuid: 80b7f903-76cd-4edf-94bf-fc34c13ee654
unsubscribed_at: null
last_notification_email_sent_at: null
email_suppression_reason: null
is_active: true
fb_url: null
twitter_url: null
instagram_url: null
linkedin_url: null
website_url: null
created_at: '2026-01-09T15:27:56.647Z'
updated_at: '2026-01-09T15:28:08.075Z'
tags: []
custom_attributes: {}
visits:
first_visit:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
last_visit: null
last_visit_with_utm:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/ContactAttributes'
example:
id: 24359
public_id: vQxYMj
workspace_id: 4
anonymous: 0
email_address: jane.doe@example.com
first_name: Jane
last_name: Doe
phone_number: '+18005550199'
time_zone: Madrid
uuid: 80b7f903-76cd-4edf-94bf-fc34c13ee654
unsubscribed_at: null
last_notification_email_sent_at: null
email_suppression_reason: null
is_active: true
fb_url: null
twitter_url: null
instagram_url: null
linkedin_url: null
website_url: null
created_at: '2026-01-09T15:27:56.647Z'
updated_at: '2026-01-09T15:28:08.075Z'
tags: []
custom_attributes: {}
visits:
first_visit:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
last_visit: null
last_visit_with_utm:
uuid: 9f2e8a22-1b65-4414-95f3-5caf0bbd11da
utm_source: google
utm_medium: cpc
utm_campaign: spring_sale
utm_term: running shoes
utm_content: ad_variant_a
ip: 192.168.1.1
user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
referrer: https://www.google.com/search?q=example
referring_domain: google.com
landing_page: https://example.com/products/shoes
browser: Chrome
os: Mac OS X
device_type: desktop
started_at: '2026-01-09T14:23:45.123Z'
created_at: '2026-01-09T14:23:45.123Z'
updated_at: '2026-01-09T14:23:45.123Z'
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: 'Bad request: HTTP body must be val
# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clickfunnels/refs/heads/main/openapi/clickfunnels-contact-api-openapi.yml