Tokei
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.
Key features
How it works
Connect
Add your Kit API key in the Tokei promotion editor.
Sync
Every new contest entrant is automatically added to your selected list or audience.
Engage
Send targeted follow-up campaigns to your freshly synced subscribers.
Setup guide
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.
Connecting to Your Promotion
Connect Kit in six steps:
- 1Open promotion in dashboard
- 2Go to Post Capture
- 3Open Kit Connection
- 4Enter API key
- 5Select form
- 6Click Connect Kit
Testing Your Integration
Validate syncing end-to-end:
- 1Create a test promotion with Kit connected
- 2Submit a test entry
- 3Confirm the subscriber appears under the selected form in Kit
- 4Check the first name and last_name custom field carried across
Field Mapping
Tokei maps entrant details onto Kit's subscriber fields:
| Field | Description |
|---|---|
| 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 |
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.
Ready to connect Kit?
Follow the step-by-step guide to set up your Kit integration in minutes.
Get started
