- Home
- Resources
- Integrations
- ConvertKit
ConvertKit n8n integrationAutomate ConvertKit with n8n.
Every subscriber action in ConvertKit can start a workflow, and every workflow can write back. The ConvertKit n8n integration ships a node with 15 operations over 5 resources, plus a trigger node that listens to 10 events. Built for people who run forms, tags and sequences without a developer.
Verified Trustpilot reviews · AI, automation & growth agency
What does the ConvertKit n8n integration actually do?
The ConvertKit node talks to the ConvertKit API from inside a workflow. It covers 5 resources, custom fields, forms, sequences, tags and tag subscribers, for 15 operations in total. A separate trigger node starts a workflow on 10 ConvertKit events spread over 7 families. Both nodes read the same API key, so one credential serves the pair.
Start with the case most teams arrive with. A signup form lives on your own site or in a spreadsheet, and the people who fill it never reach the email list. A workflow that reads the new row and runs form.addSubscriber closes that gap: the person lands in the right ConvertKit form, with a first name and any custom field you already know about. The same run can keep a copy of the row in Google Sheets so the sales side sees it too.
Second case, reacting to what subscribers do. The trigger fires on productPurchase or tagAdd, and the workflow answers inside the same execution: add the buyer to an onboarding sequence with sequence.addSubscriber, post a line in Slack for whoever owns the account, tag the record so the next campaign finds it. Nothing is scheduled and nothing is checked by hand.
Third case, moving data out. sequence.getSubscriptions and tagSubscriber.getAll return subscriber data for one sequence or one tag, with Return All switched on when you want the full list instead of the first page. That is how a segment leaves ConvertKit for a report, a webinar platform, or a second list in Mautic.
Anything outside the 15 catalogued operations goes through the HTTP Request node, which calls any ConvertKit API endpoint and reuses the same credential through predefined authentication. That is the normal way to extend the pair, not a workaround. Two habits save time along the way: create a custom field before a subscriber operation tries to fill it, and keep in mind that a required field left empty stops the node from running.
Still weighing n8n against other automation platforms before you commit? The n8n review walks through the trade-offs, and the n8n training covers building workflows like these end to end.
How do you connect ConvertKit to n8n?
- 01
Grab the API key from your ConvertKit account
A ConvertKit account is the only prerequisite. Open Account Settings, go to the Advanced section, and copy the API key shown there. That single value is what n8n asks for, and it covers both the ConvertKit node and the ConvertKit Trigger, so there is nothing else to generate on the ConvertKit side before you start building.
- 02
Create the ConvertKit credential in n8n
In n8n, open the Credentials menu and create a new ConvertKit credential. Paste the value you copied into the field named API Secret, then save it under a name you will recognize later. A credential is created once and reused in every workflow, so this step only happens the first time you touch ConvertKit.
- 03
Select the credential and load a list
Drop a ConvertKit node on the canvas and pick your credential from the dropdown at the top of the node. Choose a resource, then open the Form Name or ID or Tag Name or ID selector: if n8n fills the list with your real forms and tags, the key works. Repeat the selection on the trigger node.
What can start a workflow from ConvertKit ?
ConvertKit Trigger is the node that starts a workflow when something happens in ConvertKit. It listens to 10 events, listed below by family. Pick one or several, activate the workflow: n8n registers the webhook on your ConvertKit account.
What you see in n8n
Every event, by family
One row per object, one chip per action. The event to tick in the node is object.action; hover a chip to read exactly when it fires.
course.*2subscriber.*2tag.*2form.*1link.*1product.*1purchase.*1Configuration notes
01Configure the ConvertKit Trigger
The ConvertKit Trigger is a separate node that opens a workflow instead of closing it. You pick one value in Event, and on activation n8n registers a webhook with ConvertKit, meaning a URL that ConvertKit calls every time that event happens. Each event lands in n8n within seconds, with no polling and no interval to configure. The node is at version 1 and reads the same credential as the action node.
Key parameters
- Event: the ConvertKit event this workflow listens to, one of the 10 available across 7 families. One trigger node listens to one event, so a workflow that reacts to two different things gets two trigger nodes or two workflows.
02Form Subscribe, Sequence Subscribe and Sequence Complete
Three events cover the path a reader takes through your content. formSubscribe fires when somebody signs up through a form, courseSubscribe when a subscriber enters a sequence, and courseComplete when they reach the end of it. Together they make the form family and the course family, which hold 3 of the 10 events.
Key parameters
- Form Name or ID: the form to watch for
formSubscribe. Pick it from the list n8n loads with your credential, or supply an ID with an expression when the form changes per run. - Sequence Name or ID: the sequence to watch for
courseSubscribeandcourseComplete, chosen the same way.
03Tag Add, Tag Remove, Subscriber Activated and Subscriber Unsubscribe
Four events report changes on the subscriber record itself. tagAdd and tagRemove fire when a tag is applied to or pulled off a subscriber, whether a human did it in ConvertKit or an automation did. subscriberActivate and subscriberUnsubscribe mark the two ends of the relationship. That is 4 of the 10 events, across the tag family and the subscriber family.
Key parameters
- Tag Name or ID: the tag that
tagAddortagRemovewatches, selected from the loaded list or set through an expression.
tagAdd is often the cleanest hand-off between a person clicking around in ConvertKit and a workflow doing the rest. The unsubscribe event earns its place too, since it is the moment to stop every other system from mailing that address.04Link Click, Product Purchase and Purchase Created
The last three events come from what a subscriber does with money or with a link. linkClick fires when someone clicks a specific URL you nominate, productPurchase when a given product is bought, and purchaseCreate when a purchase is created. Each one sits in its own family, which is part of why 10 events spread over 7 families here.
Key parameters
- Initiating Link: the URL of the initiating link for
linkClick, typed in full rather than picked from a list. - Product ID: the identifier of the product watched by
productPurchase, also entered as a value.
What can the ConvertKit node do in a workflow?
The ConvertKit node exposes 15 operations across 5 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.
| Resource | Create | Get Many | Update | Delete | Add | Add Subscriber | Get Subscriptions |
|---|---|---|---|---|---|---|---|
| Custom Field | ✓ | ✓ | ✓ | ✓ | |||
| Form | ✓ | ✓ | ✓ | ||||
| Sequence | ✓ | ✓ | ✓ | ||||
| Tag | ✓ | ✓ | |||||
| Tag Subscriber | ✓ | ✓ | ✓ |
Operations index
Custom Field
4 operationsCreate a custom field
customField.createWhat you see in n8n
Notes & use cases
Custom fields hold the data ConvertKit does not keep by default, such as a plan name or an acquisition source. This operation creates one in the account so that subscriber operations have somewhere to write.
Key parameters
- Label: the label of the custom field, the wording you will see in ConvertKit and in the Add Custom Field picker of the subscriber operations.
Delete a custom field
customField.deleteWhat you see in n8n
Notes & use cases
Fields pile up faster than anyone expects, and a field nobody fills makes the account harder to read. This operation removes one field from ConvertKit.
Key parameters
- Field ID: the ID of your custom field, not its label. Get many custom fields is the operation that hands you that identifier when you only know the wording.
Get many custom fields
customField.getAllWhat you see in n8n
Notes & use cases
Lists the custom fields defined in the account, each with its label and its identifier. It is the operation that turns a field name you know into the ID that the update and delete operations expect.
Key parameters
- Return All: on, n8n walks the API pages and brings back every field in the account; off, Limit caps how many fields come back.
Update a custom field
customField.updateWhat you see in n8n
Notes & use cases
Changes the label of a field that already exists in ConvertKit. Handy when the wording chosen in a hurry stops matching what the field actually contains.
Key parameters
- Field ID: the ID of your custom field, the field being renamed.
- Label: the new label of the custom field, which is what appears in ConvertKit afterwards.
Form
3 operationsAdd a subscriber
form.addSubscriberWhat you see in n8n
Notes & use cases
Puts an email address into a ConvertKit form, which is how somebody joins the list from outside ConvertKit. The form you choose decides what happens next on the ConvertKit side.
Key parameters
- Form Name or ID: the target form, picked from the list n8n loads or supplied as an ID through an expression.
- Email: the subscriber's email address, in the shape
name@email.com. - First Name and Custom Fields, in Additional Fields: key and value pairs that travel with the subscriber. The custom field has to exist before you can use it here.
Get many forms
form.getAllWhat you see in n8n
Notes & use cases
Returns the forms that exist in the account. Useful when a workflow has to choose a form by name at runtime rather than having one hard-wired into the node.
Key parameters
- Return All: on for a full inventory of the account's forms; off, Limit sets the maximum number of forms returned.
Get all subscriptions
form.getSubscriptionsWhat you see in n8n
Notes & use cases
Lists the subscriptions to one form, including the subscriber data attached to each of them. This is the acquisition view: who came in through this particular form.
Key parameters
- Form Name or ID: the form whose subscriptions you want to read.
- Subscriber State, in Additional Fields:
activeorcancelled, to separate the people still on the list from those who left. - Return All: on for the whole history of the form; off, Limit stops the run earlier.
Sequence
3 operationsAdd a subscriber
sequence.addSubscriberWhat you see in n8n
Notes & use cases
Drops someone straight into a sequence, so the emails start arriving in the order you set up in ConvertKit. Unlike the form route, this targets the automated series itself.
Key parameters
- Sequence Name or ID: the sequence to enroll the person into.
- Email: the subscriber's email address, in the shape
name@email.com. - Tag Names or IDs, First Name and Custom Fields, in Additional Fields: tags and values applied at the same time, which saves a second operation later.
Get many sequences
sequence.getAllWhat you see in n8n
Notes & use cases
Reads back the sequences configured in the account, with the identifier of each one. It is the check you run before a workflow tries to enrol anybody, so a renamed sequence does not break the rest.
Key parameters
- Return All: on to list every sequence; off, Limit decides how many come back.
Get all subscriptions to a sequence
sequence.getSubscriptionsWhat you see in n8n
Notes & use cases
Returns everyone subscribed to a given sequence, subscriber data included. Where the form version answers how people arrived, this one answers who is currently going through the series.
Key parameters
- Sequence Name or ID: the sequence being read.
- Subscriber State, in Additional Fields: keep
activefor people still in the flow, orcancelledto study the drop-offs. - Return All: on to page through the entire sequence; off, Limit caps the result.
Tag
2 operationsCreate a tag
tag.createWhat you see in n8n
Notes & use cases
Adds a tag to the ConvertKit account so that subscribers can carry it afterwards. Creating the tag and applying it are two separate steps here.
Key parameters
- Name: the tag name. Several tags can be created in one go by separating the names with a comma.
Get many tags
tag.getAllWhat you see in n8n
Notes & use cases
Brings back the tags that exist in the account. Most teams reach for it to avoid a near-duplicate, since ConvertKit accounts tend to accumulate three spellings of the same idea.
Key parameters
- Return All: on to pull the complete tag list; off, Limit fixes the maximum number returned.
Tag Subscriber
3 operationsAdd a tag to a subscriber
tagSubscriber.addWhat you see in n8n
Notes & use cases
Applies an existing tag to one person, identified by their email address. This is the segmentation workhorse: most ConvertKit logic downstream keys off tags.
Key parameters
- Tag Name or ID: the tag being applied, from the loaded list or through an expression.
- Email: the subscriber email address, in the shape
name@email.com. - First Name and Custom Fields, in Additional Fields: values written on the subscriber at the same time, with the custom field created beforehand.
Get many tag subscriptions
tagSubscriber.getAllWhat you see in n8n
Notes & use cases
Every subscriber carrying one given tag comes back here, subscriber data included. In practice this is how a segment becomes a concrete list of people you can act on outside ConvertKit.
Key parameters
- Tag Name or ID: the tag whose subscribers you want.
- Subscriber State, in Additional Fields:
activeorcancelled, depending on whether the segment is for sending or for analysis. - Return All: on for the full segment; off, Limit trims it.
Delete a tag from a subscriber
tagSubscriber.deleteWhat you see in n8n
Notes & use cases
Takes a tag off one subscriber without touching the tag itself, which stays available for everybody else in the account.
Key parameters
- Tag Name or ID: the tag to remove from this person.
- Email: the subscriber email address, in the shape
name@email.com.
Need help automating ConvertKit with n8n?
A person reads every message.

