Tokei
Automatically sync contest entrants to your Mailchimp audience. When someone enters your promotion, they are added to your mailing list instantly.
Key features
How it works
Connect
Add your Mailchimp 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, gather these three things from your Mailchimp account:
API Key
Mailchimp -> Account -> Extras -> API keys -> Create key. Copy the full key (for example: xxxxxxxxx-us1).
Server Prefix
This is the suffix in your API key. If your key ends with -us1, your server prefix is us1.
Audience ID (List ID)
Audience -> Manage Audience -> Settings -> Audience name and defaults. Copy Audience ID.
Connecting to Your Promotion
Follow these steps to connect Mailchimp to your promotion:
- 1Open your promotion in the Tokei dashboard
- 2Go to the Email Integration section
- 3Click Connect Mailchimp
- 4Enter API key, server prefix, and audience ID
- 5Select the audience to sync subscribers to
- 6Save your settings
What Happens When Someone Enters
When a participant submits their email:
- They are added to your selected Mailchimp audience
- They are tagged with source and contest metadata
- Existing subscribers are updated instead of duplicated
Automatic Tagging
Tokei applies tags/fields to support segmentation:
| Field | Description |
|---|---|
| Source Identifier | tokei |
| Contest Tag | contest-your-contest-name |
| Entry Tag | contest-entry |
| Name Fields | FNAME / LNAME when available |
Double Opt-in
If your audience uses double opt-in, subscribers receive a confirmation email before full subscription.
This is controlled in Mailchimp audience settings, not in Tokei.
Troubleshooting
API key not working?
Generate a fresh API key and ensure your server prefix is correct.
Audience not found?
Confirm audience ID in Mailchimp and reconnect with the correct value.
Subscribers not appearing?
Submit a new test entry and allow a short sync delay.
Ready to connect Mailchimp?
Follow the step-by-step guide to set up your Mailchimp integration in minutes.
Get started
