ConvertKit
EmailAPI keyConnection test available
Kit (formerly ConvertKit) subscribers, tags, forms and sequences on API v4.
OCNORA ships 24 typed ConvertKit operations and 1 trigger. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run. Endpoints not covered by a typed node are called at https://api.kit.com/v4 through the HTTP node with the same credential.
Before you connect ConvertKit
- Authentication
- API key
- Credential
- the Kit v4 API key ({"api_key": …}) or an OAuth {"access_token": …}the v4 API key, or {"api_key": "…"}, or {"access_token": "…"} for OAuth
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
- Prerequisites
- A v4 API key (X-Kit-Api-Key) or an OAuth token — a v3 api_key/api_secret pair is a different, incompatible credential and Kit answers it with 401. Publishing also needs MANTLE_APP_PUBLIC_BASE_URL set to a publicly reachable URL: Kit refuses to deliver to private, internal or loopback addresses.
Prerequisites are taken from the connection notes in this provider’s node contracts; each node’s reference page says which apply to it.
What you can do with ConvertKit
Operations, grouped by what they do to your data, plus 1 trigger that start a run.
Create and send 5
Read and search 11
Delete and cancel 1
A sample ConvertKit workflow
- 1Eventtrigger.convertkit_eventStart a run when Kit (ConvertKit) emits an event — a subscriber, tag, form, sequence or broadcast change.
- 2Get Accountconvertkit.get_accountFetch the authenticated Kit account and user, including the plan and the verified sending addresses.
- 3Add Subscriber To Formconvertkit.add_subscriber_to_formSubscribe an existing subscriber to a form, identified either by their Kit id or by their email address.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Operations 24
- Add Subscriber To FormSubscribe an existing subscriber to a form, identified either by their Kit id or by their email address.convertkit.add_subscriber_to_form
- Add Subscriber To SequenceEnrol an existing subscriber in a sequence, identified either by their Kit id or by their email address.convertkit.add_subscriber_to_sequence
- Bulk Create SubscribersCreate many subscribers in one call, reporting Kit's per-item failures for a batch it processed synchronously.convertkit.bulk_create_subscribers
- Bulk Create TagsCreate many tags in one call, returning the tags Kit created or matched and any it refused.convertkit.bulk_create_tags
- Bulk Tag SubscribersApply many tag-to-subscriber pairs in one call, reporting Kit's per-pair failures for a batch it processed synchronously.convertkit.bulk_tag_subscribers
- Create SequenceCreate an email sequence and set the schedule it sends on.convertkit.create_sequence
- Create SubscriberCreate a subscriber from an email address, or return the existing record when Kit already knows that address.convertkit.create_subscriber
- Create TagCreate a tag by name, or return the existing tag when the name is already taken (Kit matches names case-insensitively).convertkit.create_tag
- Get AccountFetch the authenticated Kit account and user, including the plan and the verified sending addresses.convertkit.get_account
- Get SequenceFetch one sequence by its Kit id, with its schedule and email count.convertkit.get_sequence
- Get SubscriberFetch one subscriber by their Kit id, with their custom field values.convertkit.get_subscriber
- List Subscribers For FormList the subscribers who joined through one form, each with the time they were added and the referrer they arrived on.convertkit.list_form_subscribers
- List FormsList the account's forms and landing pages, filtering by status or type.convertkit.list_forms
- List Subscribers For SequenceList the subscribers enrolled in one sequence, each with the time they entered it.convertkit.list_sequence_subscribers
- List SequencesList the account's email sequences, optionally with their send statistics.convertkit.list_sequences
- List Subscriber TagsList the tags applied to one subscriber, each with the time it was applied.convertkit.list_subscriber_tags
- List SubscribersList and search subscribers on the account, filtering by email address, state or sign-up date and paging with Kit's cursors.convertkit.list_subscribers
- List Subscribers For TagList the subscribers carrying one tag, each with the time the tag was applied to them.convertkit.list_tag_subscribers
- List TagsList every tag on the account, optionally with each tag's subscriber count.convertkit.list_tags
- Remove Tag From SubscriberRemove a tag from a subscriber, identified either by their Kit id or by their email address. The subscriber itself is kept.convertkit.remove_tag_from_subscriber
- Tag SubscriberApply a tag to a subscriber, identified either by their Kit id or by their email address.convertkit.tag_subscriber
- Unsubscribe SubscriberMove a subscriber to the cancelled state, keeping their record, history and tags in the account.convertkit.unsubscribe_subscriber
- Update SubscriberUpdate a subscriber's email address, first name or custom field values.convertkit.update_subscriber
- Rename TagRename an existing tag; it keeps its id and all of its subscribers.convertkit.update_tag
ConvertKit questions
- How does OCNORA authenticate with ConvertKit?
- With a stored API key credential, shaped the Kit v4 API key ({"api_key": …}) or an OAuth {"access_token": …} or the v4 API key, or {"api_key": "…"}, or {"access_token": "…"} for OAuth. A connection test can check it when you add it.
- What can I automate with ConvertKit?
- 24 typed operations and 1 trigger, each with a reference page listing its config fields and the shapes it emits.
- What if the ConvertKit operation I need is not listed?
- Call https://api.kit.com/v4 from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use ConvertKit?
- Not yet. Start from a blank workflow, or describe the workflow to Build with AI.
- How are ConvertKit calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
See your first ConvertKit workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.