Share via


ConvertKit (Independent Publisher)

ConvertKit is the go-to marketing hub for creators that helps you grow and monetize your audience with ease. Convert your followers from social media, YouTube, and more to your email list with a beautiful landing page and opt-in templates.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connector Metadata
Publisher Troy Taylor, Hitachi Solutions
Website https://convertkit.com/
Privacy policy https://convertkit.com/privacy
Categories Marketing

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Secret securestring The API Secret for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add subscriber to a form

Subscribe an email address to one of your forms.

Add subscriber to a sequence

Subscribe an email address to one of your sequences.

Create a broadcast

Create a draft or scheduled broadcast. You can create a draft broadcast without any attributes. Scheduled broadcasts at a minimum should contain a subject line and your content.

Create a purchase

Create a purchase.

Create a tag

Creates a new tag.

Destroy a broadcast

Permanently delete a draft or scheduled broadcast record. Broadcasts that are currently sending or that have been sent may not be deleted.

Get a purchase

Retrieve a specific purchase by ID.

Get a subscriber

Retrieves a single subscriber record.

Get account

Retrieves the current account.

Get broadcast stats

Retrieves the statistics (recipient count, open rate, click rate, unsubscribe count, total clicks, status, and send progress) for a specific broadcast.

Get forms

Retrieve a list of all the forms for your account.

List broadcasts

Retrieves a list of all the broadcasts for your account.

List purchases

Retrieve a list of all purchases for an account.

List sequences

Retrieves a list of sequences for the account.

List subscriber's tags

Retrieves a list of all the tags for a subscriber.

List subscribers

Returns a list of your subscribers. For unsubscribes only, use the cancelled at value for sort field param (currently the only supported extra sort field).

List subscriptions to a form

Retrieves a list of subscriptions to a form including subscriber data.

List subscriptions to a sequence

Retrieves subscriptions to a sequence including subscriber data.

List subscriptions to a tag

Retrieves a list of subscriptions to a tag including subscriber data.

List tags

Retrieves a list of tags for the account.

Remove tag from subscriber

Removes a tag from a subscriber.

Remove tag from subscriber by email

Remove a tag from a subscriber by email address.

Retrieve a broadcast

Retrieves the details of a specific broadcast, including draft, scheduled, and previously-sent broadcasts.

Tag a subscriber

Tags are handled as subscriptions. Subscribe an email address to a tag to have that tag applied to the subscriber with that email address.

Unsubscribe subscriber

Unsubscribe a subscriber from all your forms and sequences.

Update a broadcast

Updates the attributes of a specific broadcast. Broadcasts that are currently sending or that have been sent may not be updated.

Update subscriber

Updates the information for a single subscriber.

Add subscriber to a form

Subscribe an email address to one of your forms.

Parameters

Name Key Required Type Description
Form ID
form_id True string

The form unique identifier.

Email
email True string

The email address.

First Name
first_name string

The first name.

Tags
tags array of integer

Returns

Name Path Type Description
ID
subscription.id integer

The unique identifier.

State
subscription.state string

The state.

Created At
subscription.created_at string

When created at.

Source
subscription.source string

The source.

Referrer
subscription.referrer string

The referrer.

Subscribable ID
subscription.subscribable_id integer

The subscribable unique identifier.

Subscribable Type
subscription.subscribable_type string

The subscribable type.

ID
subscription.subscriber.id integer

The unique identifier.

First Name
subscription.subscriber.first_name string

The first name.

Email Address
subscription.subscriber.email_address string

The email address.

State
subscription.subscriber.state string

The state.

Created At
subscription.subscriber.created_at string

When created at.

Add subscriber to a sequence

Subscribe an email address to one of your sequences.

Parameters

Name Key Required Type Description
Sequence ID
sequence_id True string

The sequence unique identifier.

Email
email True string

The email address.

First Name
first_name string

The first name.

Tags
tags array of integer

Returns

Name Path Type Description
ID
subscription.id integer

The unique identifier.

State
subscription.state string

The state.

Created At
subscription.created_at string

When created at.

Source
subscription.source string

The source.

Referrer
subscription.referrer string

The referrer.

Subscribable ID
subscription.subscribable_id integer

The subscribable unique identifier.

Subscribable Type
subscription.subscribable_type string

The subscribable type.

ID
subscription.subscriber.id integer

The unique identifier.

Create a broadcast

Create a draft or scheduled broadcast. You can create a draft broadcast without any attributes. Scheduled broadcasts at a minimum should contain a subject line and your content.

Parameters

Name Key Required Type Description
Description
description string

The description.

Subject
subject string

The subject.

Content
content string

The content.

Email Address
email_address string

The email address.

Email Layout Template
email_layout_template string

The email layout template.

Public
public boolean

Whether public.

Published At
published_at string

When published at.

Send At
send_at string

When send at.

Thumbnail Alt
thumbnail_alt string

The alt-text for the thumbnail.

Thumbnail URL
thumbnail_url string

The URL address for the thumbnail.

Returns

Name Path Type Description
ID
broadcast.id integer

The unique identifier.

Created At
broadcast.created_at string

When created at.

Subject
broadcast.subject string

The subject.

Description
broadcast.description string

The description.

Content
broadcast.content string

The content.

Public
broadcast.public boolean

Whether public.

Published At
broadcast.published_at string

When published at.

Send At
broadcast.send_at string

When sent at.

Thumbnail Alt
broadcast.thumbnail_alt string

The alt-text for the thumbnail.

Thumbnail URL
broadcast.thumbnail_url string

The URL address for thumbnail.

Email Address
broadcast.email_address string

The email address.

Email Layout Template
broadcast.email_layout_template string

The email layout template.

Create a purchase

Create a purchase.

Parameters

Name Key Required Type Description
Transaction ID
transaction_id True string

The transaction unique identifier.

Email Address
email_address True string

The email address.

First Name
first_name string

The first name.

Currency
currency True string

The currency.

Transaction Time
transaction_time string

The transaction time.

Subtotal
subtotal integer

The subtotal.

Tax
tax integer

The tax.

Shipping
shipping integer

The shipping.

Discount
discount integer

The discount.

Total
total integer

The total.

Status
status string

The status.

PID
pid True integer

The personal identifier.

LID
lid True integer

The LID.

Name
name True string

The name.

SKU
sku string

The SKU.

Unit Price
unit_price True integer

The unit price.

Quantity
quantity True integer

The quantity.

Returns

Name Path Type Description
ID
id integer

The unique identifier.

Transaction ID
transaction_id string

The transaction unique identifier.

Status
status string

The status.

Email Address
email_address string

The email address.

Currency
currency string

The currency.

Transaction Time
transaction_time string

The transaction time.

Subtotal
subtotal integer

The subtotal.

Discount
discount integer

The discount.

Tax
tax integer

The tax.

Shipping
shipping integer

The shipping.

Total
total integer

The total.

Products
products array of object
Unit Price
products.unit_price integer

The unit price.

Quantity
products.quantity integer

The quantity.

SKU
products.sku string

The SKU.

Name
products.name string

The name.

Create a tag

Creates a new tag.

Parameters

Name Key Required Type Description
Name
name True string

The name.

Returns

Name Path Type Description
Account ID
account_id integer

The account unique identifier.

Created At
created_at string

When created at.

Deleted At
deleted_at string

When deleted at.

ID
id integer

The unique identifier.

Name
name string

The name.

State
state string

The state.

Updated At
updated_at string

When updated at.

Destroy a broadcast

Permanently delete a draft or scheduled broadcast record. Broadcasts that are currently sending or that have been sent may not be deleted.

Parameters

Name Key Required Type Description
Broadcast ID
broadcast_id True string

The broadcast unique identifier.

Returns

response
string

Get a purchase

Retrieve a specific purchase by ID.

Parameters

Name Key Required Type Description
Purchase ID
purchase_id True string

The purchase identifier.

Returns

Name Path Type Description
ID
id integer

The unique identifier.

Transaction ID
transaction_id string

The transaction unique identifier.

Status
status string

The status.

Email Address
email_address string

The email address.

Currency
currency string

The currency.

Transaction Time
transaction_time string

The transaction time.

Subtotal
subtotal integer

The subtotal.

Shipping
shipping integer

The shipping.

Discount
discount integer

The discount.

Tax
tax integer

The tax.

Total
total integer

The total.

Products
products array of object
Unit Price
products.unit_price integer

The unit price.

Quantity
products.quantity integer

The quantity.

SKU
products.sku string

The SKU.

Name
products.name string

The name.

Get a subscriber

Retrieves a single subscriber record.

Parameters

Name Key Required Type Description
Subscriber ID
subscriber_id True string

The subscriber unique identifier.

Returns

Name Path Type Description
ID
subscriber.id integer

The unique identifier.

First Name
subscriber.first_name string

The first name.

Email Address
subscriber.email_address string

The email address.

State
subscriber.state string

The state.

Created At
subscriber.created_at string

When created at.

Last Name
subscriber.fields.last_name string

The last name.

Get account

Retrieves the current account.

Returns

Name Path Type Description
Name
name string

The name.

Plan Type
plan_type string

The type of plan.

Primary Email Address
primary_email_address string

The primary email address.

Get broadcast stats

Retrieves the statistics (recipient count, open rate, click rate, unsubscribe count, total clicks, status, and send progress) for a specific broadcast.

Parameters

Name Key Required Type Description
Broadcast ID
broadcast_id True string

The broadcast unique identifier.

Returns

Name Path Type Description
Broadcast
broadcast array of object
ID
broadcast.id integer

The unique identifier.

Recipients
broadcast.stats.recipients integer

The recipients.

Open Rate
broadcast.stats.open_rate float

The open rate.

Click Rate
broadcast.stats.click_rate float

The click rate.

Unsubscribes
broadcast.stats.unsubscribes integer

The unsubscribes.

Total Clicks
broadcast.stats.total_clicks integer

The total clicks.

Show Total Clicks
broadcast.stats.show_total_clicks boolean

Whether to show total clicks.

Status
broadcast.stats.status string

The status.

Progress
broadcast.stats.progress integer

The progress.

Get forms

Retrieve a list of all the forms for your account.

Returns

Name Path Type Description
Forms
forms array of object
ID
forms.id integer

The unique identifier.

Name
forms.name string

The name.

Created At
forms.created_at string

When created at.

Type
forms.type string

The type.

Format
forms.format string

The format.

URL
forms.url string

The URL address.

Embed JS
forms.embed_js string

The Javascript to embed.

Embed URL
forms.embed_url string

The URL address to embed.

Title
forms.title string

The title.

Description
forms.description string

The description.

Sign Up Button Text
forms.sign_up_button_text string

The sign up button text.

Success Message
forms.success_message string

The success message.

Archived
forms.archived boolean

Whether archived.

UID
forms.uid string

The unique identifier.

List broadcasts

Retrieves a list of all the broadcasts for your account.

Returns

Name Path Type Description
Broadcasts
broadcasts array of object
ID
broadcasts.id integer

The unique identifier.

Created At
broadcasts.created_at string

When created at.

Subject
broadcasts.subject string

The subject.

List purchases

Retrieve a list of all purchases for an account.

Parameters

Name Key Required Type Description
Page
page integer

The page.

Returns

Name Path Type Description
Total Purchases
total_purchases integer

The total purchases.

Page
page integer

The page.

Total Pages
total_pages integer

The total pages.

Purchases
purchases array of object
ID
purchases.id integer

The unique identifier.

Transaction ID
purchases.transaction_id string

The transaction unique identifier.

Status
purchases.status string

The status.

Email Address
purchases.email_address string

The email address.

Currency
purchases.currency string

The currency.

Transaction Time
purchases.transaction_time string

The transaction time.

Subtotal
purchases.subtotal integer

The subtotal.

Shipping
purchases.shipping integer

The shipping.

Discount
purchases.discount integer

The discount.

Tax
purchases.tax integer

The tax.

Total
purchases.total integer

The total.

Products
purchases.products array of object
Unit Price
purchases.products.unit_price integer

The unit price.

Quantity
purchases.products.quantity integer

The quantity.

SKU
purchases.products.sku string

The SKU.

Name
purchases.products.name string

The name.

List sequences

Retrieves a list of sequences for the account.

Returns

Name Path Type Description
Courses
courses array of object
ID
courses.id integer

The unique identifier.

Name
courses.name string

The name.

Created At
courses.created_at string

When created at.

List subscriber's tags

Retrieves a list of all the tags for a subscriber.

Parameters

Name Key Required Type Description
Subscriber ID
subscriber_id True string

The subscriber unique identifier.

Returns

Name Path Type Description
Tags
tags array of object
ID
tags.id integer

The unique identifier.

Name
tags.name string

The name.

Created At
tags.created_at string

When created at.

List subscribers

Returns a list of your subscribers. For unsubscribes only, use the cancelled at value for sort field param (currently the only supported extra sort field).

Parameters

Name Key Required Type Description
From
from string

The from.

To
to string

The to.

Updated From
updated_from string

When updated from.

Updated To
updated_to string

When updated to.

Sort Order
sort_order string

The sort order.

Sort Field
sort_field string

The sort field.

Email Address
email_address string

The email address.

Page
page integer

The page.

Returns

Name Path Type Description
Total Subscribers
total_subscribers integer

The total subscribers.

Page
page integer

The page.

Total Pages
total_pages integer

The total pages.

Subscribers
subscribers array of object
ID
subscribers.id integer

The unique identifier.

First Name
subscribers.first_name string

The first name.

Email Address
subscribers.email_address string

The email address.

State
subscribers.state string

The state.

Created At
subscribers.created_at string

When created at.

Last Name
subscribers.fields.last_name string

The last name.

List subscriptions to a form

Retrieves a list of subscriptions to a form including subscriber data.

Parameters

Name Key Required Type Description
Form ID
form_id True string

The form unique identifier.

Sort Order
sort_order string

The sort order.

Subscriber State
subscriber_state string

The state of the subscriber.

Page
page integer

The page.

Returns

Name Path Type Description
Total Subscriptions
total_subscriptions integer

The total subscriptions.

Page
page integer

The page.

Total Pages
total_pages integer

The total pages.

Subscriptions
subscriptions array of object
ID
subscriptions.id integer

The unique identifier.

State
subscriptions.state string

The state.

Created At
subscriptions.created_at string

When created at.

Source
subscriptions.source string

The source.

Referrer
subscriptions.referrer string

The referrer.

Subscribable ID
subscriptions.subscribable_id integer

The subscribable unique identifier.

Subscribable Type
subscriptions.subscribable_type string

The subscribable type.

ID
subscriptions.subscriber.id integer

The unique identifier.

First Name
subscriptions.subscriber.first_name string

The first name.

Email Address
subscriptions.subscriber.email_address string

The email address.

State
subscriptions.subscriber.state string

The state.

Created At
subscriptions.subscriber.created_at string

When created at.

Last Name
subscriptions.subscriber.fields.last_name string

The last name.

List subscriptions to a sequence

Retrieves subscriptions to a sequence including subscriber data.

Parameters

Name Key Required Type Description
Sequence ID
sequence_id True string

The sequence unique identifier.

Sort Order
sort_order string

The sort order.

Subscriber State
subscriber_state string

The state of the subscriber.

Page
page integer

The page.

Returns

Name Path Type Description
Total Subscriptions
total_subscriptions integer

The total subscriptions.

Page
page integer

The page.

Total Pages
total_pages integer

The total pages.

Subscriptions
subscriptions array of object
ID
subscriptions.id integer

The unique identifier.

State
subscriptions.state string

The state.

Created At
subscriptions.created_at string

When created at.

Source
subscriptions.source string

The source.

Referrer
subscriptions.referrer string

The referrer.

Subscribable ID
subscriptions.subscribable_id integer

The subscribable unique identifier.

Subscribable Type
subscriptions.subscribable_type string

The subscribable type.

ID
subscriptions.subscriber.id integer

The unique identifier.

First Name
subscriptions.subscriber.first_name string

The first name.

Email Address
subscriptions.subscriber.email_address string

The email address.

State
subscriptions.subscriber.state string

The state.

Created At
subscriptions.subscriber.created_at string

When created at.

Last Name
subscriptions.subscriber.fields.last_name string

The last name.

List subscriptions to a tag

Retrieves a list of subscriptions to a tag including subscriber data.

Parameters

Name Key Required Type Description
Tag ID
tag_id True string

The tag unique identifier.

Sort Order
sort_order string

The sort order.

Subscriber State
subscriber_state string

The state of the subscriber.

Page
page integer

The page.

Returns

Name Path Type Description
Total Subscriptions
total_subscriptions integer

The total subscriptions.

Page
page integer

The page.

Total Pages
total_pages integer

The total pages.

Subscriptions
subscriptions array of object
ID
subscriptions.id integer

The unique identifier.

State
subscriptions.state string

The state.

Created At
subscriptions.created_at string

When created at.

Source
subscriptions.source string

The source.

Referrer
subscriptions.referrer string

The referrer.

Subscribable ID
subscriptions.subscribable_id integer

The subscribable unique identifier.

Subscribable Type
subscriptions.subscribable_type string

The subscribable type.

ID
subscriptions.subscriber.id integer

The unique identifier.

First Name
subscriptions.subscriber.first_name string

The first name.

Email Address
subscriptions.subscriber.email_address string

The email address.

State
subscriptions.subscriber.state string

The state.

Created At
subscriptions.subscriber.created_at string

When created at.

Last Name
subscriptions.subscriber.fields.last_name string

The last name.

List tags

Retrieves a list of tags for the account.

Returns

Name Path Type Description
Tags
tags array of object
ID
tags.id integer

The unique identifier.

Name
tags.name string

The name.

Created At
tags.created_at string

When created at.

Remove tag from subscriber

Removes a tag from a subscriber.

Parameters

Name Key Required Type Description
Subscriber ID
subscriber_id True string

The subscriber unique identifier.

Tag ID
tag_id True string

The tag unique identifier.

Returns

Name Path Type Description
ID
id integer

The unique identifier.

Name
name string

The name.

Created At
created_at string

When created at.

Remove tag from subscriber by email

Remove a tag from a subscriber by email address.

Parameters

Name Key Required Type Description
Tag ID
tag_id True string

The tag unique identifier.

Email
email True string

The email address.

Returns

Name Path Type Description
ID
id integer

The unique identifier.

Name
name string

The name.

Created At
created_at string

When created at.

Retrieve a broadcast

Retrieves the details of a specific broadcast, including draft, scheduled, and previously-sent broadcasts.

Parameters

Name Key Required Type Description
Broadcast ID
broadcast_id True string

The broadcast unique identifier.

Returns

Name Path Type Description
ID
broadcast.id integer

The unique identifier.

Created At
broadcast.created_at string

When created at.

Subject
broadcast.subject string

The subject.

Description
broadcast.description string

The description.

Content
broadcast.content string

The content.

Public
broadcast.public boolean

Whether public.

Published At
broadcast.published_at string

When published at.

Send At
broadcast.send_at string

When sent at.

Thumbnail Alt
broadcast.thumbnail_alt string

The alt-text for the thumbnail.

Thumbnail URL
broadcast.thumbnail_url string

The URL address for thumbnail.

Email Address
broadcast.email_address string

The email address.

Email Layout Template
broadcast.email_layout_template string

The email layout template.

Tag a subscriber

Tags are handled as subscriptions. Subscribe an email address to a tag to have that tag applied to the subscriber with that email address.

Parameters

Name Key Required Type Description
Tag ID
tag_id True string

The tag unique identifier.

Email
email string

The email address.

First Name
first_name string

The first name.

Tags
tags array of integer

Returns

Name Path Type Description
ID
subscription.id integer

The unique identifier.

State
subscription.state string

The state.

Created At
subscription.created_at string

When created at.

Source
subscription.source string

The source.

Referrer
subscription.referrer string

The referrer.

Subscribable ID
subscription.subscribable_id integer

The subscribable unique identifier.

Subscribable Type
subscription.subscribable_type string

The subscribable type.

ID
subscription.subscriber.id integer

The unique identifier.

Unsubscribe subscriber

Unsubscribe a subscriber from all your forms and sequences.

Parameters

Name Key Required Type Description
Email
email True string

The email address.

Returns

Name Path Type Description
ID
subscriber.id integer

The unique identifier.

First Name
subscriber.first_name string

The first name.

Email Address
subscriber.email_address string

The email address.

State
subscriber.state string

The state.

Created At
subscriber.created_at string

When created at.

Last Name
subscriber.fields.last_name string

The last name.

Update a broadcast

Updates the attributes of a specific broadcast. Broadcasts that are currently sending or that have been sent may not be updated.

Parameters

Name Key Required Type Description
Broadcast ID
broadcast_id True string

The broadcast unique identifier.

Description
description string

The description.

Subject
subject string

The subject.

Content
content string

The content.

Email Address
email_address string

The email address.

Email Layout Template
email_layout_template string

The email layout template.

Public
public boolean

Whether public.

Published At
published_at string

When published at.

Send At
send_at string

When send at.

Thumbnail Alt
thumbnail_alt string

The alt-text for the thumbnail.

Thumbnail URL
thumbnail_url string

The URL address for the thumbnail.

Returns

Name Path Type Description
ID
broadcast.id integer

The unique identifier.

Created At
broadcast.created_at string

When created at.

Subject
broadcast.subject string

The subject.

Description
broadcast.description string

The description.

Content
broadcast.content string

The content.

Public
broadcast.public boolean

Whether public.

Published At
broadcast.published_at string

When published at.

Send At
broadcast.send_at string

When sent at.

Thumbnail Alt
broadcast.thumbnail_alt string

The alt-text for the thumbnail.

Thumbnail URL
broadcast.thumbnail_url string

The URL address for thumbnail.

Email Address
broadcast.email_address string

The email address.

Email Layout Template
broadcast.email_layout_template string

The email layout template.

Update subscriber

Updates the information for a single subscriber.

Parameters

Name Key Required Type Description
Subscriber ID
subscriber_id True string

The subscriber unique identifier.

First Name
first_name string

The first name.

Email Address
email_address string

The email address.

Returns

Name Path Type Description
ID
subscriber.id integer

The unique identifier.

First Name
subscriber.first_name string

The first name.

Email Address
subscriber.email_address string

The email address.

State
subscriber.state string

The state.

Created At
subscriber.created_at string

When created at.

Definitions

string

This is the basic data type 'string'.