Kit (formerly ConvertKit) Integration
Connect Articfly to your Kit (formerly ConvertKit) newsletter and send AI-generated articles as broadcasts to your subscribers, all subscribers, a single tag, or a single segment. Default behavior is "create as draft" so you can review every email before it ships.
Prerequisites
- ›A Kit Creator or Pro plan ($33/mo or higher). Kit's broadcast API is gated behind paid plans, the free Newsletter plan does NOT include API access. Articfly checks this at connect time and surfaces a clear error if you're on the free tier.
- ›A Kit V4 API key, generated in your developer settings (instructions below).
- ›Active Articfly account, sign up at app.articfly.com.
Connecting Your Kit Newsletter
Two steps. Generate an API key, pick an audience.
Generate a Kit V4 API key
Open app.kit.com/account_settings/developer_settings. Scroll to the V4 Keys section and click Add a new key. Name it Articfly and copy the generated key, it starts with kit_. Kit only shows the secret once.
Paste the key and pick an audience
In the Articfly dashboard, go to Integrations → Kit. Paste the key and click Continue. Articfly verifies your account and fetches your tags and segments. Pick an audience: All subscribers, a single tag, or a single segment, and click Connect Kit. Every Articfly broadcast targets this audience.
What the Integration Does
Draft by Default
Articfly creates broadcasts as drafts by default. You review the email in Kit's broadcast editor and click Send when ready. This is intentional, accidental sends to your full subscriber list are expensive to recover from.
Opt-In Send Immediately
Tick the Send to subscribers immediately checkbox on the article publish screen and the broadcast goes out the moment Articfly creates it. Use this only when you're sure, it cannot be undone via the API.
Audience Targeting
Articfly forwards your audience choice (all subs / single tag / single segment) as a Kit subscriber_filter on every broadcast. Want to switch? Disconnect and reconnect with a different audience.
HTML Email Body
Kit accepts HTML natively. Articfly sends the article body as HTML, Kit renders headings, paragraphs, lists, and inline images in the broadcast template you have configured in your Kit account.
Subject & Preview Text
Article title becomes the email subject. The article excerpt becomes the preview text (the line shown in the inbox after the subject). Edit either on the Articfly article detail page before publishing.
Encrypted Key Storage
Your Kit API key is encrypted at rest using AES-256-GCM. Articfly only decrypts it server-side at the moment of publish.
Security Notes
- ›The Kit V4 API key gives full account access, broadcasts, subscribers, tags, segments. Treat it like a password.
- ›All API calls use HTTPS to
api.kit.com/v4with a 30-second timeout. Articfly never logs the raw key. - ›To fully revoke access, delete the API key in Kit's developer settings, disconnecting in Articfly clears the local copy but does not invalidate the key on Kit's side.
Troubleshooting
"Kit API key invalid or plan does not include API access"
Two possible causes. First, your Kit account is on the free Newsletter plan, Kit gates broadcast API access behind Creator and Pro plans ($33/mo+). Upgrade in Kit's billing settings. Second, the key was deleted from Kit developer settings or you copied a V3 key (V3 is deprecated). Re-generate a V4 key and reconnect.
"The selected Kit tag does not belong to this account"
The tag you picked at connect time was deleted in Kit afterward. Reconnect Articfly to re-fetch your current tags and segments and pick a fresh audience.
Broadcast created but I cannot edit it
Once a Kit broadcast has been sent, Kit's API does not allow updates or deletions. If you ticked Send immediately by mistake, the broadcast is locked. Future republishes from Articfly will create a new draft broadcast in Kit instead of trying to update the sent one.
Email looks unstyled or different from my Kit template
Kit applies the email template you have set as default to every broadcast, Articfly only sends the HTML body. If the email is unstyled, check your default broadcast template in Kit's broadcast settings. Custom Kit theme blocks (image headers, signature blocks, footer CTAs) only render if your template includes them.