Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

ConvertKit

Email marketing for creators

CategoryMarketing
Authenticationcustom
Version0.3.8
Published scopes0 published scopes
Last updatedSeptember 21, 2026

Overview

Connect ConvertKit with Flows360

Email marketing for creators

Use the ConvertKit connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 35 actions and 12 triggers.

Available actions

  • Get Subscriber By Id
  • Get Subscriber By Email
  • List Subscribers
  • Update Subscriber
  • Unsubscribe Subscriber
  • List Tags By Email
  • List Tags By Subscriber Id
  • Add Webhook
  • Plus 27 additional declared actions.

Available triggers

  • Tag added to subscriber
  • Tag removed from subscriber
  • Subscriber activated
  • Subscriber unsubscribed
  • Subscriber bounced
  • Subscriber complained
  • Plus 6 additional declared triggers.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: ConvertKit
  • Package: @activepieces/piece-convertkit@0.3.8
  • Exact artifact digest: sha256:0defb13313499ba7f07a9f40d66a8933be96baf22a1b6b9f90477d74490b7d2b
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Get Subscriber By Id (subscribers_get_subscriber_by_id), Returns data for a single subscriber Classification: read.
  • Get Subscriber By Email (subscribers_get_subscriber_by_email), Returns data for a single subscriber Classification: read.
  • List Subscribers (subscribers_list_subscribers), Returns a list of all subscribers Classification: read.
  • Update Subscriber (subscribers_update_subscriber), Update a subscriber Classification: read.
  • Unsubscribe Subscriber (subscribers_unsubscribe_subscriber), Unsubscribe a subscriber Classification: read.
  • List Tags By Email (subscribers_list_tags_by_email), Returns a list of all subscribed tags Classification: read.
  • List Tags By Subscriber Id (subscribers_list_tags_by_subscriber_id), Returns a list of all subscribed tags Classification: read.
  • Add Webhook (create_webhook), Create a webhook automation Classification: read.
  • Delete Webhook (destroy_webhook), Delete a webhook automation Classification: read.
  • List Custom Fields (custom_fields_list_fields), Returns a list of all custom fields Classification: read.
  • Create Custom Field (custom_fields_create_field), Create a new custom field Classification: read.
  • Custom Fields: Update Field (custom_fields_update_field), Update a custom field Classification: read.
  • Custom Fields: Delete Field (custom_fields_delete_field), Delete a custom field Classification: read.
  • List Broadcasts (broadcasts_list_broadcasts), List all broadcasts Classification: read.
  • Create Broadcast (broadcasts_create_broadcast), Create a new broadcast Classification: read.
  • Get Broadcast (broadcasts_get_broadcast), Get a broadcast Classification: read.
  • Update Broadcast (broadcasts_update_broadcast), Update a broadcast Classification: read.
  • Delete Broadcast (broadcasts_delete_broadcast), Delete a broadcast Classification: read.
  • Broadcast Stats (broadcasts_broadcast_stats), Get broadcast stats Classification: read.
  • List Forms (forms_list_forms), Returns a list of all forms Classification: read.
  • Add Subscriber To Form (forms_add_subscriber_to_form), Add a subscriber to a form Classification: read.
  • List Form Subscriptions (forms_list_form_subscriptions), List form subscriptions Classification: read.
  • List Sequences (sequences_list_sequences), Returns a list of all sequences Classification: read.
  • Add Subscriber To Sequence (sequences_add_subscriber_to_sequence), Add a subscriber to a sequence Classification: read.
  • List Subscriptions To Sequence (sequences_list_subscriptions_to_sequence), List all subscriptions to a sequence Classification: read.
  • List Tags (tags_list_tags), Returns a list of all tags Classification: read.
  • Create Tag (tags_create_tag), Create a tag Classification: read.
  • Tag Subscriber (tags_tag_subscriber), Tag a subscriber Classification: read.
  • Remove Tag From Subscriber By Email (tags_remove_tag_from_subscriber_by_email), Remove a tag from a subscriber by email Classification: read.
  • Remove Tag From Subscriber By Id (tags_remove_tag_from_subscriber_by_id), Remove a tag from a subscriber by id Classification: read.
  • List Subscriptions To Tag (tags_list_subscriptions_to_tag), List all subscriptions to a tag Classification: read.
  • List Purchases (purchases_list_purchases), Returns a list of all purchases Classification: read.
  • Get Purchase By Id (purchases_get_purchase_by_id), Returns data for a single purchase Classification: read.
  • Create Purchase (purchases_create_purchase), Creates a new purchase Classification: read.
  • Create Multiple Purchases (purchases_create_multiple_purchases), Creates multiple purchases Classification: read.

Trigger contracts

  • Tag added to subscriber, webhook.
  • Tag removed from subscriber, webhook.
  • Subscriber activated, webhook.
  • Subscriber unsubscribed, webhook.
  • Subscriber bounced, webhook.
  • Subscriber complained, webhook.
  • Form subscribed, webhook.
  • Sequence subscribed, webhook.
  • Sequence completed, webhook.
  • Link clicked, webhook.
  • Product purchased, webhook.
  • Purchase created, webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects47
Supported actions35
Triggers12

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Secret Required · protected credential

Supported objects

ObjectReadWriteNotes
Get Subscriber By Id Yes No Returns data for a single subscriber
Get Subscriber By Email Yes No Returns data for a single subscriber
List Subscribers Yes No Returns a list of all subscribers
Update Subscriber Yes No Update a subscriber
Unsubscribe Subscriber Yes No Unsubscribe a subscriber
List Tags By Email Yes No Returns a list of all subscribed tags
List Tags By Subscriber Id Yes No Returns a list of all subscribed tags
Add Webhook Yes No Create a webhook automation
Delete Webhook Yes No Delete a webhook automation
List Custom Fields Yes No Returns a list of all custom fields
Create Custom Field Yes No Create a new custom field
Custom Fields: Update Field Yes No Update a custom field
Custom Fields: Delete Field Yes No Delete a custom field
List Broadcasts Yes No List all broadcasts
Create Broadcast Yes No Create a new broadcast
Get Broadcast Yes No Get a broadcast
Update Broadcast Yes No Update a broadcast
Delete Broadcast Yes No Delete a broadcast
Broadcast Stats Yes No Get broadcast stats
List Forms Yes No Returns a list of all forms
Add Subscriber To Form Yes No Add a subscriber to a form
List Form Subscriptions Yes No List form subscriptions
List Sequences Yes No Returns a list of all sequences
Add Subscriber To Sequence Yes No Add a subscriber to a sequence
List Subscriptions To Sequence Yes No List all subscriptions to a sequence
List Tags Yes No Returns a list of all tags
Create Tag Yes No Create a tag
Tag Subscriber Yes No Tag a subscriber
Remove Tag From Subscriber By Email Yes No Remove a tag from a subscriber by email
Remove Tag From Subscriber By Id Yes No Remove a tag from a subscriber by id
List Subscriptions To Tag Yes No List all subscriptions to a tag
List Purchases Yes No Returns a list of all purchases
Get Purchase By Id Yes No Returns data for a single purchase
Create Purchase Yes No Creates a new purchase
Create Multiple Purchases Yes No Creates multiple purchases
Tag added to subscriber Yes No webhook trigger declared by the pinned package.
Tag removed from subscriber Yes No webhook trigger declared by the pinned package.
Subscriber activated Yes No webhook trigger declared by the pinned package.
Subscriber unsubscribed Yes No webhook trigger declared by the pinned package.
Subscriber bounced Yes No webhook trigger declared by the pinned package.
Subscriber complained Yes No webhook trigger declared by the pinned package.
Form subscribed Yes No webhook trigger declared by the pinned package.
Sequence subscribed Yes No webhook trigger declared by the pinned package.
Sequence completed Yes No webhook trigger declared by the pinned package.
Link clicked Yes No webhook trigger declared by the pinned package.
Product purchased Yes No webhook trigger declared by the pinned package.
Purchase created Yes No webhook trigger declared by the pinned package.

Supported actions

Get Subscriber By Id · Read

Returns data for a single subscriber

subscribers_get_subscriber_by_id · Risk: low · Retry: safe

Inputs

  • subscriberId · string · Required, The subscriber ID
Get Subscriber By Email · Read

Returns data for a single subscriber

subscribers_get_subscriber_by_email · Risk: low · Retry: safe

Inputs

  • email_address · string · Required, The email of the subscriber
List Subscribers · Read

Returns a list of all subscribers

subscribers_list_subscribers · Risk: low · Retry: safe

Inputs

  • page · number · Optional, Page number. Each page of results will contain up to 50 subscribers.
  • sortOrder · string · Required, Sort order
  • sortField · string · Optional, Sort field
  • from · string · Optional, Return subscribers created after this date
  • to · string · Optional, Return subscribers created before this date
  • updatedFrom · string · Optional, Return subscribers updated after this date
  • updatedTo · string · Optional, Return subscribers updated before this date
  • emailAddress · string · Required, The email of the subscriber
Update Subscriber · Read

Update a subscriber

subscribers_update_subscriber · Risk: low · Retry: safe

Inputs

  • subscriberId · string · Required, The subscriber ID
  • emailAddress · string · Optional, The email of the subscriber
  • firstName · string · Optional, The first name of the subscriber
  • fields · object · Optional, The custom fields
Unsubscribe Subscriber · Read

Unsubscribe a subscriber

subscribers_unsubscribe_subscriber · Risk: low · Retry: safe

Inputs

  • email · string · Required, The email of the subscriber
List Tags By Email · Read

Returns a list of all subscribed tags

subscribers_list_tags_by_email · Risk: low · Retry: safe

Inputs

  • email_address · string · Required, The email of the subscriber
List Tags By Subscriber Id · Read

Returns a list of all subscribed tags

subscribers_list_tags_by_subscriber_id · Risk: low · Retry: safe

Inputs

  • subscriberId · string · Required, The subscriber ID
Add Webhook · Read

Create a webhook automation

create_webhook · Risk: low · Retry: safe

Inputs

  • targetUrl · string · Required, The URL that will be called when the webhook is triggered
  • event · string · Required, The event that will trigger the webhook
  • eventParameter · object · Optional, The required parameter for the event
Delete Webhook · Read

Delete a webhook automation

destroy_webhook · Risk: low · Retry: safe

Inputs

  • webhookId · number · Required, The webhook rule id
List Custom Fields · Read

Returns a list of all custom fields

custom_fields_list_fields · Risk: low · Retry: safe

Create Custom Field · Read

Create a new custom field

custom_fields_create_field · Risk: low · Retry: safe

Inputs

  • fields · array · Required, The custom fields
Custom Fields: Update Field · Read

Update a custom field

custom_fields_update_field · Risk: low · Retry: safe

Inputs

  • label · string · Required
  • new_label · string · Required, The new label for the custom field
Custom Fields: Delete Field · Read

Delete a custom field

custom_fields_delete_field · Risk: low · Retry: safe

Inputs

  • label · string · Required
List Broadcasts · Read

List all broadcasts

broadcasts_list_broadcasts · Risk: low · Retry: safe

Inputs

  • page · number · Optional, Page number. Each page of results will contain up to 50 broadcasts.
Create Broadcast · Read

Create a new broadcast

broadcasts_create_broadcast · Risk: low · Retry: safe

Inputs

  • content · string · Optional, The broadcast's email content - this can contain text and simple HTML markdown (such as h1, img or p tags)
  • description · string · Optional, An internal description of this broadcast
  • emailAddress · string · Optional, Sending email address; leave blank to use your account's default sending email address
  • emailLayoutTemplate · string · Optional, Name of the email template to use; leave blank to use your account's default email template
  • isPublic · boolean · Optional, Specifies whether or not this is a public post
  • publishedAt · string · Optional, Specifies the time that this post was published (applicable only to public posts)
  • sendAt · string · Optional, Time that this broadcast should be sent; leave blank to create a draft broadcast. If set to a future time, this is the time that the broadcast will be scheduled to send.
  • subject · string · Optional, The broadcast email's subject
  • thumbnailAlt · string · Optional, Specify the ALT attribute of the public thumbnail image (applicable only to public posts)
  • thumbnailUrl · string · Optional, Specify the URL of the thumbnail image to accompany the broadcast post (applicable only to public posts)
Get Broadcast · Read

Get a broadcast

broadcasts_get_broadcast · Risk: low · Retry: safe

Inputs

  • broadcastId · string · Required, The broadcast id
Update Broadcast · Read

Update a broadcast

broadcasts_update_broadcast · Risk: low · Retry: safe

Inputs

  • broadcastId · string · Required, The broadcast id
  • content · string · Optional, The broadcast's email content - this can contain text and simple HTML markdown (such as h1, img or p tags)
  • description · string · Optional, An internal description of this broadcast
  • emailAddress · string · Optional, Sending email address; leave blank to use your account's default sending email address
  • emailLayoutTemplate · string · Optional, Name of the email template to use; leave blank to use your account's default email template
  • isPublic · boolean · Optional, Specifies whether or not this is a public post
  • publishedAt · string · Optional, Specifies the time that this post was published (applicable only to public posts)
  • sendAt · string · Optional, Time that this broadcast should be sent; leave blank to create a draft broadcast. If set to a future time, this is the time that the broadcast will be scheduled to send.
  • subject · string · Optional, The broadcast email's subject
  • thumbnailAlt · string · Optional, Specify the ALT attribute of the public thumbnail image (applicable only to public posts)
  • thumbnailUrl · string · Optional, Specify the URL of the thumbnail image to accompany the broadcast post (applicable only to public posts)
Delete Broadcast · Read

Delete a broadcast

broadcasts_delete_broadcast · Risk: low · Retry: safe

Inputs

  • broadcastId · string · Required, The broadcast id
Broadcast Stats · Read

Get broadcast stats

broadcasts_broadcast_stats · Risk: low · Retry: safe

Inputs

  • broadcastId · string · Required, The broadcast id
List Forms · Read

Returns a list of all forms

forms_list_forms · Risk: low · Retry: safe

Add Subscriber To Form · Read

Add a subscriber to a form

forms_add_subscriber_to_form · Risk: low · Retry: safe

Inputs

  • formId · string · Required
  • email · string · Required, The email of the subscriber
  • firstName · string · Optional, The first name of the subscriber
  • tags · array · Optional, Choose the Tags
  • fields · object · Optional, The custom fields
List Form Subscriptions · Read

List form subscriptions

forms_list_form_subscriptions · Risk: low · Retry: safe

Inputs

  • formId · string · Required
List Sequences · Read

Returns a list of all sequences

sequences_list_sequences · Risk: low · Retry: safe

Add Subscriber To Sequence · Read

Add a subscriber to a sequence

sequences_add_subscriber_to_sequence · Risk: low · Retry: safe

Inputs

  • sequenceId · string · Required
  • email · string · Required, The email of the subscriber
  • firstName · string · Optional, The first name of the subscriber
  • tags · array · Optional, Choose the Tags
  • fields · object · Optional, The custom fields
List Subscriptions To Sequence · Read

List all subscriptions to a sequence

sequences_list_subscriptions_to_sequence · Risk: low · Retry: safe

Inputs

  • sequenceId · string · Required
List Tags · Read

Returns a list of all tags

tags_list_tags · Risk: low · Retry: safe

Create Tag · Read

Create a tag

tags_create_tag · Risk: low · Retry: safe

Inputs

  • name · string · Required, The name of the tag
Tag Subscriber · Read

Tag a subscriber

tags_tag_subscriber · Risk: low · Retry: safe

Inputs

  • email · string · Required, The email of the subscriber
  • firstName · string · Optional, The first name of the subscriber
  • tags · array · Required, Choose the Tags
  • fields · object · Optional, The custom fields
Remove Tag From Subscriber By Email · Read

Remove a tag from a subscriber by email

tags_remove_tag_from_subscriber_by_email · Risk: low · Retry: safe

Inputs

  • email · string · Required, The email of the subscriber
  • tagId · string · Required, The tag to remove
Remove Tag From Subscriber By Id · Read

Remove a tag from a subscriber by id

tags_remove_tag_from_subscriber_by_id · Risk: low · Retry: safe

Inputs

  • subscriberId · string · Required, The subscriber ID
  • tagId · string · Required, The tag to remove
List Subscriptions To Tag · Read

List all subscriptions to a tag

tags_list_subscriptions_to_tag · Risk: low · Retry: safe

Inputs

  • tagId · string · Required, Choose a Tag
  • page · number · Optional, Each page of results will contain up to 50 tags.
  • sortOrder · string · Optional, Sort order
  • subscriberState · string · Optional, Subscriber state
List Purchases · Read

Returns a list of all purchases

purchases_list_purchases · Risk: low · Retry: safe

Inputs

  • page · number · Required, Page number. Each page of results will contain up to 50 purchases.
Get Purchase By Id · Read

Returns data for a single purchase

purchases_get_purchase_by_id · Risk: low · Retry: safe

Inputs

  • purchaseId · string · Required, The purchase ID
Create Purchase · Read

Creates a new purchase

purchases_create_purchase · Risk: low · Retry: safe

Inputs

  • transactionId · number · Required, The transaction ID
  • transactionTime · string · Optional, The transaction time
  • emailAddress · string · Required, The email address of the subscriber
  • firstName · string · Optional, The first name of the subscriber
  • status · string · Optional, The status of the purchase
  • currency · string · Required, The currency of the purchase
  • subtotal · number · Optional, The subtotal
  • shipping · number · Optional, The shipping
  • discount · number · Optional, The discount
  • tax · number · Optional, The tax
  • total · number · Optional, The total
  • pid · number · Required, The product ID
  • lid · number · Required, The line item ID
  • name · string · Required, The name of the product
  • sku · string · Optional, The SKU of the product
  • unit_price · number · Required, The unit price of the product
  • quantity · number · Required, The quantity of the product
Create Multiple Purchases · Read

Creates multiple purchases

purchases_create_multiple_purchases · Risk: low · Retry: safe

Inputs

  • transactionId · number · Required, The transaction ID
  • transactionTime · string · Optional, The transaction time
  • emailAddress · string · Required, The email address of the subscriber
  • firstName · string · Optional, The first name of the subscriber
  • status · string · Optional, The status of the purchase
  • currency · string · Required, The currency of the purchase
  • subtotal · number · Optional, The subtotal
  • shipping · number · Optional, The shipping
  • discount · number · Optional, The discount
  • tax · number · Optional, The tax
  • total · number · Optional, The total
  • multipleProducts · object · Required, The products

Triggers

Tag added to subscriber · Webhook

Trigger when a tag is added to a subscriber

Inputs

  • tagId · string
Tag removed from subscriber · Webhook

Trigger when a tag is removed from a subscriber

Inputs

  • tagId · string
Subscriber activated · Webhook

Trigger when a subscriber is activated. This happens when a subscriber confirms their subscription.

Subscriber unsubscribed · Webhook

Trigger when a subscriber is unsubscribed

Subscriber bounced · Webhook

Trigger when a subscriber bounced. This happens when an email is sent to a subscriber and the email bounces.

Subscriber complained · Webhook

Trigger when a subscriber complained. This happens when a subscriber marks an email as spam.

Form subscribed · Webhook

Trigger when a form is subscribed

Inputs

  • formId · string
Sequence subscribed · Webhook

Trigger when a sequence is subscribed

Inputs

  • sequenceIdChoice · string
Sequence completed · Webhook

Trigger when a sequence is completed

Inputs

  • sequenceIdChoice · string
Link clicked · Webhook

Trigger when a link is clicked

Inputs

  • initiatorValue · string
Product purchased · Webhook

Trigger when a product is purchased

Inputs

  • productId · number
Purchase created · Webhook

Trigger when a purchase is created

Setup

Setup

  1. Add the ConvertKit connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-convertkit@0.3.8; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 35 actions and 12 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required ConvertKit connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-convertkit@0.3.8 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com