1. Home
  2. Docs
  3. Integrations
  4. ConvertKit


ConvertKit is a newsletter service that allows you to collect emails. You can connect the whole site or just a specific giveaway to a ConvertKit list and you will see your list being populated with emails of those who subscribes to your giveaways.


API KeyConvertKit API key
Disable Subscribed EmailIn case you have your own welcome email prepared to work with Simple Giveaways, you can disable the default email from this plugin. Read below on how to prepare it.
ListHere, you will be able to choose a list from ConvertKit once the API Key is entered and saved.

Preparing the ConvertKit Welcome Email for Simple Giveaways

If you are going to use the welcome email instead of the default one, be sure to prepare it so it includes the links that are specific to that subscriber.

When a subscriber signs up to the giveaway, he/she gets a unique reference ID and also a share ID. The reference ID is used so that they can login at any time by visiting the link.

Those IDs are saved to the list and related to the subscriber. In a new list, such IDs or values of them won’t exist (or be the same).

To prepare your email, you will need to enter the link to your giveaway (or where the shortcode is) and then add the links as seen in the picture below.

The example links are:

  • https://yoursite.com/giveaway/GIVEAWAY-SLUG?ref={{ subscriber.refid }}
  • https://yoursite.com/giveaway/GIVEAWAY-SLUG?share={{ subscriber.shareid }}

In both cases, the first part of the link is the same. The only difference are the query parameters ref and share. The tags subscriber.refid and subscriber.shareid are unique to each subscriber.

In case you are also using the Activation option, be sure to include the activation link. It is recommend to put the activation link in a button so it catches the eye of the subscriber.

The activation link is the same as the reference link but it contains another query parameter activate=1 so the link looks like this: https://yoursite.com/giveaway/GIVEAWAY-SLUG?ref={{ subscriber.refid }}&activate=1.

Using a Different ConvertKit list for a Giveaway

By default, each giveaway will use the list you’ve selected in the ConvertKit integration settings. If you want to use a different list, you will need to change it on the Giveaway edit page.

You can then choose instead of the Default List, a different list.

Disabling the ConvertKit on a Giveaway

You can also disable ConvertKit on a giveaway by choosing to disable it in the same metabox.

Was this article helpful to you? Yes No

How can we help?