List Subscribers For Form
convertkit.list_form_subscribers
ActionEmailconnection required
Calls the ConvertKit API with the connection's credentials.
List the subscribers who joined through one form, each with the time they were added and the referrer they arrived on.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- ConvertKit
- Secret shape
- the v4 API key, or {"api_key": "…"}, or {"access_token": "…"} for OAuth
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
11 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
form_id The Kit id of the form. | string | Yes | — | — | 287 |
status Only return subscribers in this state. Kit defaults to 'active'. | string | No | — | one of "active", "cancelled", "bounced", "complained", "inactive", "all" | — |
added_after Only include records added to the form on or after this date (ISO 8601). | string | No | — | iso8601 format | 2026-01-01 |
added_before Only include records added to the form on or before this date (ISO 8601). | string | No | — | iso8601 format | — |
created_after Only include records created on or after this date (ISO 8601). | string | No | — | iso8601 format | 2026-01-01 |
created_before Only include records created on or before this date (ISO 8601). | string | No | — | iso8601 format | — |
slim Omit each subscriber's custom 'fields' object for a faster response. | boolean | No | false | — | — |
per_page How many records to ask Kit for in one page (Kit's default is 500). | number | No | — | 1–1000 | 100 |
after Cursor for the next page: the 'end_cursor' from a previous run of this node. | string | No | — | — | — |
before Cursor for the previous page: the 'start_cursor' Kit returned earlier. | string | No | — | — | — |
include_total_count Ask Kit for the total number of matching records. It slows the call, so set it on the first page only. | boolean | No | false | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"added_after": "2026-01-01",
"created_after": "2026-01-01",
"form_id": "287",
"include_total_count": false,
"per_page": 100,
"slim": false
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
items The records on this page, exactly as Kit returned them. | array | — |
returned How many records this page contains. | number | — |
total_count Total matching records, or null unless 'include_total_count' was set. | number | — |
has_next_page True when another page of records follows. | boolean | — |
end_cursor Cursor to pass as 'after' on the next run to fetch the following page. | string | — |
{
"end_cursor": "",
"has_next_page": false,
"items": [],
"returned": 0,
"total_count": 0
}See List Subscribers For Form run in a workflow.
In a technical demo we add the ConvertKit connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.