ConvertKit Integration

Automatically add email signups from your promo code campaigns to your ConvertKit forms and sequences.

What You'll Need

• A ConvertKit account
• At least one ConvertKit form or tag
• A Promo Code Queue account with an active promotion

Step 1: Get Your ConvertKit API Key

1. Log in to your ConvertKit account
2. Click "Settings" in the top right
3. Navigate to "Advanced" → "API"
4. Copy your "API Secret" (not the API Key)

Step 2: Find Your Form ID or Tag ID

You can add subscribers to either a form or a tag:

Option A: Using a Form

1. In ConvertKit, go to "Grow" → "Landing Pages & Forms"
2. Click on the form you want to use
3. Look at the URL - the Form ID is the number: convertkit.com/forms/1234567/edit

Option B: Using a Tag

1. Go to "Subscribers" → "Tags"
2. Click on the tag you want to use
3. The Tag ID is in the URL: convertkit.com/subscribers/tags/1234567

Step 3: Connect ConvertKit in Promo Code Queue

1. Go to your Dashboard → Settings → Integrations
2. Find "ConvertKit" and click "Connect"
3. Enter your ConvertKit API Secret
4. Click "Test Connection"
5. Choose whether to add subscribers to a Form or Tag
6. Enter the Form ID or Tag ID
7. Click "Save"

Step 4: Enable ConvertKit for Your Promotion

1. Navigate to your promotion
2. Go to Settings → Email Capture
3. Toggle "Send to ConvertKit" to ON
4. Select the form or tag to use
5. Optional: Add custom fields (e.g., promotion name, claimed code)
6. Click "Save Settings"

Using Custom Fields

You can send additional data to ConvertKit as custom fields. This is useful for segmentation and personalization.

Available fields:

• promotion_name - Name of the promo campaign
• promotion_url - URL of the promotion
• claimed_code - Whether they claimed a code (yes/no)
• signup_date - When they signed up

Troubleshooting

Error: "Invalid API Secret"

• Make sure you're using the API Secret, not the API Key
• Check for any extra spaces when copying
• Try generating a new API Secret in ConvertKit

Emails not appearing in ConvertKit

• Check if the subscriber is in "Unsubscribed" status
• Verify the Form ID or Tag ID is correct
• ConvertKit prevents duplicate emails - check if the email already exists
• Look in Settings → Integrations → Delivery Logs for errors

Custom fields not populating

• Ensure you've created the custom fields in ConvertKit first
• Custom field names are case-sensitive
• Check the field mapping in your integration settings

Advanced: Automation Ideas

Once subscribers are in ConvertKit, you can automate follow-ups:

1. Welcome Sequence for Code Claimers

• Day 0: Thank them for claiming a code
• Day 3: Ask for feedback on your app
• Day 7: Request an App Store review
• Day 14: Announce next giveaway or feature

2. Waitlist Sequence for Missed Users

• Day 0: Sorry codes ran out, you're on the waitlist
• Day 7: Share a discount code as consolation
• Day 14: Announce next giveaway (give them first access)

3. Segment by Promotion Type

• Tag users by which campaign they came from
• Send targeted emails based on their interests
• Create lookalike audiences for paid ads

Next Steps