Kit Integration
Automatically add contest entrants as subscribers to a Kit form, triggering its confirmation email and any connected sequences.
Kit (formerly ConvertKit) is ideal for creators running newsletters, courses, and sequence-driven follow-up.
What You'll Need
Before connecting, prepare:
API Key
Kit -> Settings -> Developer -> API Keys. Copy the v4 API key (not the older v3 API secret).
Target Form
Kit -> Grow -> Landing Pages & Forms. Choose or create the form entrants should be added to.
Note: Kit uses forms, not lists. Adding a subscriber to a form is what starts its sequences, so pick the form whose follow-up you want entrants to receive.
Connecting to Your Promotion
Connect Kit in six steps:
Open promotion in dashboard
Go to Post Capture
Open Kit Connection
Enter API key
Select form
Click Connect Kit
Testing Your Integration
Validate syncing end-to-end:
Create a test promotion with Kit connected
Submit a test entry
Confirm the subscriber appears under the selected form in Kit
Check the first name and last_name custom field carried across
Field Mapping
Tokei maps entrant details onto Kit's subscriber fields:
email_address
Entrant email (Kit's required field)
first_name
Entrant first name, native Kit field
fields.last_name
Entrant last name — Kit has no native last name, so this is a custom field
state
Set to active on creation
Note: If last names are not appearing, add a custom field named last_name in Kit -> Subscribers -> Custom Fields.
Troubleshooting
Auth/key errors
Confirm you pasted a v4 API key from Settings -> Developer. A v3 API secret will not authenticate.
Form cannot be selected
Archived forms are hidden. Ensure the form exists and is not archived in Kit.
Subscriber added but no email received
Check the form's own confirmation and incentive settings in Kit — Tokei triggers them, it does not send them.
Rate limit responses
Kit allows 120 requests per minute. Retry after a delay and avoid rapid reconnect attempts.
Full documentation index: tokei.io/llms.txt