Pipory
Node reference

Kit

Kit node reference - all 62 operations, the credential it needs, and a worked example.

Kit (formerly ConvertKit) v4 API (Email marketing). 62 operations: subscribers (upsert, get, list, advanced boolean search, update, unsubscribe, tags, engagement stats); tags (create, rename, list, tag or untag by email or ID, list a tag's subscribers); forms and landing pages (list, add a subscriber by email or ID, list a form's subscribers); sequences (full CRUD, enroll a subscriber, list enrollments) and sequence emails (full CRUD); broadcasts (full CRUD plus stats and link clicks); custom fields; snippets; posts, email templates and segments; purchases; and webhook registration.

Credential: Kit (ConvertKit) API key - see Credentials.

Permissions

The Kit v4 API has no scope system on the credential this node uses. An account API key (Settings > Developer, sent as X-Kit-Api-Key) can call every operation below with whatever authority the account already has, so a refusal is never a missing checkbox - a 401 means the key is wrong or was rotated, and a 422 means the request body is. Kit ALSO offers OAuth2, but its own docs contradict each other on whether that has scopes: every bulk-endpoint page says a token needs read or write, while the PKCE flow page states that the "default scope is public" and "fine-grained access control via scopes [is] coming soon". Rather than publish a scope table built on that disagreement, note the one thing that IS unambiguous: two families - every bulk/* endpoint and POST /v4/purchases - require OAuth rather than an API key, which is why neither is implemented on this node.

Operations (62)

Subscribers

OperationWhat it does
createSubscriberCreate / update subscriber (upsert by email)
getSubscriberGet subscriber
listSubscribersList subscribers
filterSubscribersAdvanced subscriber search
updateSubscriberUpdate subscriber
unsubscribeSubscriberUnsubscribe subscriber
listSubscriberTagsList a subscriber's tags
getSubscriberStatsGet a subscriber's engagement stats

Tags

OperationWhat it does
tagSubscriberTag a subscriber by email
tagSubscriberByIdTag a subscriber by ID
removeTagFromSubscriberRemove a tag from a subscriber by ID
removeTagFromSubscriberByEmailRemove a tag from a subscriber by email
listTagSubscribersList subscribers with a tag
listTagsList tags
createTagCreate tag
updateTagRename tag

Forms

OperationWhat it does
addSubscriberToFormAdd a subscriber to a form by email
addSubscriberToFormByIdAdd a subscriber to a form by ID
listFormSubscribersList a form's subscribers
listFormsList forms and landing pages

Sequences

OperationWhat it does
addSubscriberToSequenceAdd a subscriber to a sequence by email
addSubscriberToSequenceByIdAdd a subscriber to a sequence by ID
listSequenceSubscribersList a sequence's subscribers
listSequencesList sequences
createSequenceCreate sequence
getSequenceGet sequence
updateSequenceUpdate sequence
deleteSequenceDelete sequence

Sequence emails

OperationWhat it does
listSequenceEmailsList sequence emails
createSequenceEmailCreate sequence email
getSequenceEmailGet sequence email
updateSequenceEmailUpdate sequence email
deleteSequenceEmailDelete sequence email

Broadcasts

OperationWhat it does
listBroadcastsList broadcasts
createBroadcastCreate broadcast
getBroadcastGet broadcast
updateBroadcastUpdate broadcast
deleteBroadcastDelete broadcast
listBroadcastStatsList broadcasts with stats
getBroadcastStatsGet a broadcast's stats
getBroadcastClicksGet a broadcast's link clicks

Custom fields

OperationWhat it does
listCustomFieldsList custom fields
createCustomFieldCreate custom field
updateCustomFieldRename custom field
deleteCustomFieldDelete custom field

Snippets

OperationWhat it does
listSnippetsList snippets
createSnippetCreate snippet
getSnippetGet snippet
updateSnippetUpdate / archive snippet

Content & lists

OperationWhat it does
listPostsList posts
getPostGet post
listEmailTemplatesList email templates
listSegmentsList segments

Purchases

OperationWhat it does
listPurchasesList purchases
getPurchaseGet purchase

Webhooks

OperationWhat it does
listWebhooksList webhooks
createWebhookCreate webhook
deleteWebhookDelete webhook

Account

OperationWhat it does
getAccountGet the current account
getCreatorProfileGet the creator profile
getEmailStatsGet account email stats
getGrowthStatsGet account growth stats

Example

Create the subscriber before trying to tag them

Until the Kit operation wave this node had two operations and neither could create a subscriber — both only attached an ALREADY-EXISTING one to a form or a tag, which made them unusable as the first Kit step in a workflow. createSubscriber is the missing half.

Set Operation to createSubscriber, then fill in:

FieldValueNotes
email{{ myTrigger.email }}Kit's identity for a subscriber
firstName{{ myTrigger.firstName }}Kit stores only a first name
customFieldsJson{"source": "{{ myTrigger.utmSource }}"}The field must already exist in Kit; create it with createCustomField first

Sets {{subscriber.id}}, {{subscriber.email}} and {{subscriber.state}}. Note Kit's writes are eventually consistent — a read immediately after this may not see it yet.