Kit
Overview
Kit (the email platform formerly known as ConvertKit) is a creator-focused email tool built around Sequences, Forms, and Tags. AFI’s Kit integration uses the new v4 API and subscribes form submissions to a Kit Sequence (optionally also a Kit Form), captures the subscriber, and applies any tags you map. Connection is via a single V4 API Key generated in your Kit account.
Still on the legacy v3 API with an API Key + API Secret pair? Use AFI’s separate ConvertKit integration instead; it’s a distinct platform entry that targets the older endpoints.
Supported actions
- Subscribe To Sequence (Free + Pro): subscribe the form submitter to a chosen Kit Sequence, optionally also to a Kit Form; populate email + first name and apply mapped tags.
AFI Pro adds richer field mapping for Kit. More sender-plugin field types (phone, date, dropdown, hidden, custom fields) are exposed in the mapping panel, and your Kit custom subscriber fields surface alongside the standard ones; Pro also lets you map tags inline during the integration.
Quick reference
| Need to… | Do this |
|---|---|
| Subscribe to a Sequence | Create integration; Sender plugin; Kit; Subscribe To Sequence; pick the Sequence from the dropdown. |
| Subscribe to a Form too | In the same integration, also pick a Form from the Form dropdown. |
| Tag a new subscriber | On Pro, fill the Tags field; tags are created in Kit if they don’t exist. |
| Capture first name | Map the First Name field; Kit treats it as a standard subscriber attribute. |
| Map custom subscriber fields | On Pro, custom fields appear in the mapping panel automatically; refresh the dropdown after creating new fields in Kit. |
| Re-pull dropdowns | Click the refresh icon next to Sequences/Forms/Tags to re-fetch from Kit. |
Heads up: Kit’s v4 API uses a single API Key (not the old API Key + API Secret pair). Generate one in Kit > Account Settings > Developer, then paste it in AFI > Settings > Kit. The full step-by-step setup is below.
🔧 Setup Instructions
Step 1: Get API Key from Kit
- Log in to your Kit account.
- Navigate to Account Settings > Developer.
- Generate a new V4 API Key or use an existing one.
Step 2: Connect Kit in AFI
- Go to AFI → Settings → Kit tab.
- Paste your API key into the field.
- Click Save Changes.
Step 3: Create a New Integration
- Go to AFI → Add New.
- Choose your form plugin under the Trigger section.
- Under the Action section, choose:
Platform: Kit
- Task: Subscribe To Sequence
Step 4: Map Fields
- Email Address (required)
- First Name (optional)
You also need to select at least one:
- Sequence – The Kit sequence you want to subscribe the user to
- Form – A Kit form (optional)
🌟 AFI Pro Features
If you’re using the Pro version of AFI, you’ll unlock additional capabilities by selecting Kit [PRO] as the platform. This allows you to:
- Add Tags to subscribers during submission
- Map Custom Fields defined in your Kit account
To use these features, simply choose Kit [PRO] as the platform when setting up the integration, and map the additional fields as needed.
💾 Final Step
Click Save Integration to activate your setup.
🔍 Troubleshooting
If something isn’t working:
- Make sure the API key is correct.
- Check if at least one sequence or form is selected.
- Use AFI → Log to see if any API errors occurred.
- If using tags or custom fields, ensure they exist in your Kit account.
Common issues & fixes
Most Kit issues are credential- or selection-related. Work through these in order:
- Use a V4 API Key. Older v3 keys (API Key + API Secret) don’t work with this integration. If your account is still on v3, use the ConvertKit integration in AFI; otherwise generate a V4 key in Kit > Account Settings > Developer.
- Pick at least one Sequence or Form. The integration requires either a Sequence or a Form (or both); without one of them the subscriber has nowhere to land.
- Map the Email Address field. Email is mandatory; without a mapped email Kit rejects the request.
- Refresh dropdowns after creating new Kit assets. New Sequences, Forms, Tags, and custom fields need a re-fetch in AFI before they show up in the mapping panel.
Specific symptoms
- 401 Unauthorized. API Key invalid or revoked; regenerate in Kit and paste it again.
- Sequence not in dropdown. Click refresh next to the Sequence dropdown; if still missing, confirm the Sequence is published (not Draft) in Kit.
- Tags not applied. On free, the integration applies the tags configured at the Sequence level; for per-submission tag mapping use Pro and fill the Tags field.
- Custom fields not appearing. Pro is required for full custom-field mapping; click refresh in the field dropdown after adding new fields in Kit.
- Subscriber created but no Sequence emails received. Confirm the Sequence is in Published state and has at least one email; otherwise no broadcast is triggered.
Notes & caveats
- Kit, formerly ConvertKit. The platform rebranded in 2024 and moved from v3 to v4 API. AFI exposes two separate integrations: ConvertKit (v3) and Kit (v4). Pick the one that matches your API key type.
- API rate limits. Kit caps API calls per minute per account; enable AFI’s Job Queue (Settings > General) on high-volume forms to smooth bursts.
- Subscribe-to-Sequence semantics. Adding a contact to a Sequence starts them at the first email; if the contact is already in the Sequence, Kit deduplicates by email.