Resources · n8n integration

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

Why automate

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.

Connect

How do you connect ConvertKit to n8n?

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

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

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

Triggers

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.*2
    subscriber.*2
      tag.*2
        form.*1
          link.*1
            product.*1
              purchase.*1

                Configuration notes

                01Configure the ConvertKit TriggerThe 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.

                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.
                When to use it
                whenever the starting point belongs to ConvertKit rather than to your side, such as a new subscriber, a purchase, or a tag that someone applied manually.
                02Form Subscribe, Sequence Subscribe and Sequence CompleteThree 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.

                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 courseSubscribe and courseComplete, chosen the same way.
                When to use it
                a completed sequence is a strong moment for a follow-up, and a form subscribe is where enrichment belongs, before the first email goes out.
                03Tag Add, Tag Remove, Subscriber Activated and Subscriber UnsubscribeFour 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.

                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 tagAdd or tagRemove watches, selected from the loaded list or set through an expression.
                When to use it
                tags are how most ConvertKit accounts encode intent, so 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 CreatedThe 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.

                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.
                When to use it
                a click on a pricing link is a sales signal worth routing to a human, and a purchase event is the natural start of an onboarding sequence.
                Actions

                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.

                Resources × operations matrix
                ResourceCreateGet ManyUpdateDeleteAddAdd SubscriberGet Subscriptions
                Custom Field✓✓✓✓
                Form✓✓✓
                Sequence✓✓✓
                Tag✓✓
                Tag Subscriber✓✓✓

                Custom Field

                4 operations
                01

                Create a custom field

                customField.create

                What 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.
                Use cases
                an online store creates a field called Last Order Total once, at setup time, then fills it on every order the workflow processes.
                02

                Delete a custom field

                customField.delete

                What 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.
                Use cases
                a cleanup workflow run once a quarter drops the fields left behind by an old form, after a human has approved the list in Slack.
                03

                Get many custom fields

                customField.getAll

                What 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.
                Use cases
                a workflow reads the field list at the start of a run and only creates a field when the label is genuinely missing.
                04

                Update a custom field

                customField.update

                What 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.
                Use cases
                a field named Source becomes Acquisition Source across the account, in one run, instead of being renamed by hand in the ConvertKit interface.

                Form

                3 operations
                05

                Add a subscriber

                form.addSubscriber

                What 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.
                Use cases
                a webinar signup page on your own domain posts to n8n, which files each attendee in the matching ConvertKit form.
                06

                Get many forms

                form.getAll

                What 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.
                Use cases
                a monthly audit lists every form, then flags the ones that no longer appear anywhere on the website.
                07

                Get all subscriptions

                form.getSubscriptions

                What 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: active or cancelled, 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.
                Use cases
                a growth report compares the pricing page form against the blog form, month by month.

                Sequence

                3 operations
                08

                Add a subscriber

                sequence.addSubscriber

                What 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.
                Use cases
                a buyer lands in the onboarding drip the minute the purchase event reaches n8n, already tagged as a customer.
                09

                Get many sequences

                sequence.getAll

                What 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.
                Use cases
                an internal tool shows the current sequences in a dropdown, so a colleague picks one without opening ConvertKit at all.
                10

                Get all subscriptions to a sequence

                sequence.getSubscriptions

                What 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 active for people still in the flow, or cancelled to study the drop-offs.
                • Return All: on to page through the entire sequence; off, Limit caps the result.
                Use cases
                a weekly export feeds the onboarding sequence into a spreadsheet the support team already watches.

                Tag

                2 operations
                11

                Create a tag

                tag.create

                What 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.
                Use cases
                the launch of a new product creates its whole tag set in a single run, waitlist, buyer and refund included, before the first campaign goes out.
                12

                Get many tags

                tag.getAll

                What 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.
                Use cases
                before creating a tag, a workflow checks the existing names and reuses one when the label is close enough.

                Tag Subscriber

                3 operations
                13

                Add a tag to a subscriber

                tagSubscriber.add

                What 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.
                Use cases
                a support ticket marked as churn risk tags the person so the next campaign skips them.
                14

                Get many tag subscriptions

                tagSubscriber.getAll

                What 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: active or cancelled, depending on whether the segment is for sending or for analysis.
                • Return All: on for the full segment; off, Limit trims it.
                Use cases
                the webinar tag becomes an audience file for an ad platform, refreshed the morning of the session.
                15

                Delete a tag from a subscriber

                tagSubscriber.delete

                What 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.
                Use cases
                a trial user who upgrades loses the trial tag in the same workflow that grants the customer one, so no campaign treats them as both at once.
                Need help

                Need help automating ConvertKit with n8n?

                A person reads every message.

                FAQ

                ConvertKit and n8n, the questions that come next

                01Is the ConvertKit n8n integration free to use?
                Yes on the n8n side. The ConvertKit node and the ConvertKit Trigger ship with n8n, so there is nothing to install and nothing extra to pay for the connector itself. That holds on n8n Cloud, the hosted offer run by n8n, and on a self-hosted instance installed through Docker or npm under the Community Edition and its Sustainable Use license. A workflow behaves the same way in both places, so you can prototype on Cloud and move it later. What a ConvertKit account itself costs is a separate question, and this page does not cover it.
                02What credentials do you need to connect ConvertKit to n8n?
                One API key, and nothing else. ConvertKit supports API key authentication for these nodes, and the key lives in your account under Account Settings, in the Advanced section. In n8n you create a ConvertKit credential and paste that value into the field labeled API Secret. The same credential authenticates both the ConvertKit node and the ConvertKit Trigger, and once saved it is reusable across every workflow in the instance rather than being retyped each time. A quick way to confirm it works: open a Form Name or ID selector and check that your real forms appear in the list.
                03What are the limits of the ConvertKit node in n8n?
                It depends on what you need beyond the catalogue. The node exposes 15 operations over 5 resources, and anything outside that list is reached with the HTTP Request node, which calls any ConvertKit API endpoint and reuses the same credential through predefined authentication. Two practical points matter more day to day. Read operations return the first page unless Return All is enabled, with Limit setting the maximum number of items otherwise. And a custom field has to exist in the account before a subscriber operation can write into it, while any required field left empty stops the node from executing.
                04Does the ConvertKit Trigger react in real time?
                Yes, it works through a webhook. When you activate the workflow, n8n registers a webhook URL with ConvertKit, which simply means an address that ConvertKit calls each time the chosen event happens. The event reaches your workflow within seconds, so there is no polling loop and no interval to tune. You select the event in the Event parameter, and depending on which one you choose the node asks for the scope: a Form Name or ID, a Sequence Name or ID, a Tag Name or ID, an Initiating Link or a Product ID. Ten events are available in total.
                05n8n or Make for ConvertKit automation?
                It depends on four criteria, and neither tool wins them all. Hosting: n8n runs on your own server through Docker or npm, or on n8n Cloud, while Make is hosted only. Data control follows from that, since a self-hosted instance keeps subscriber emails inside your infrastructure. Cost model: Make bills per operation, which is worth simulating against a workflow that loops over a full tag export. Visual logic: both are visual builders, and the honest answer is that the one your team will actually maintain is the better choice. The n8n review linked earlier on this page goes into the detail.