Leaky Paywall - Kit (formerly ConvertKit)

The Leaky Paywall - Kit extension automatically syncs your Leaky Paywall subscribers to your Kit email marketing account. Subscribers are added to Kit and tagged based on their subscription level when they sign up, and you can configure what happens when they cancel or a payment fails.

Requirements

  • WordPress 5.0 or higher
  • Active Leaky Paywall plugin
  • Kit account with API access

Installation

Upload the leaky-paywall-kit folder to your /wp-content/plugins/ directory, activate it through the WordPress Plugins menu, and enter your license key under Leaky Paywall > Settings > Licenses.

Step 1: Add your Kit API key

Navigate to Leaky Paywall > Settings > General > Kit and enter your Kit API key. You can find this in your Kit account under Settings > Developer. After saving, your available Kit tags will be displayed on the settings page for reference.

Step 2: Configure cancel behavior

The Cancel Action setting controls what happens in Kit when a subscriber cancels their Leaky Paywall subscription:

  • Do Nothing — No changes are made in Kit.
  • Add Cancel Tag — Applies the tag specified in the Canceled Tag ID field. Use this to trigger win-back automations in Kit.
  • Unsubscribe from Kit — Fully unsubscribes the user from your Kit account.

If you select "Add Cancel Tag", enter the numeric tag ID in the Canceled Tag ID field. You can find your tag IDs listed at the bottom of the Kit settings page.

Step 3: Configure failed payment behavior

The Failed Payment Action setting controls what happens in Kit when a subscriber's payment fails (e.g. expired credit card, insufficient funds):

  • Do Nothing — No changes are made in Kit.
  • Add Failed Payment Tag — Applies the tag specified in the Failed Payment Tag ID field. Use this to trigger payment recovery or dunning automations in Kit.
  • Unsubscribe from Kit — Fully unsubscribes the user from your Kit account.

If you select "Add Failed Payment Tag", enter the numeric tag ID in the Failed Payment Tag ID field.

Step 4: Assign tags to subscription levels

Go to Leaky Paywall > Settings > Subscription Levels. For each level, you'll see a Kit Tag ID field. Enter the Kit tag ID you want assigned to new subscribers of that level. This field is optional — levels without a tag will still sync subscribers to Kit, but no tag will be applied.

How It Works

  • New subscriber — When a reader subscribes through Leaky Paywall, they are automatically added to your Kit account. If their subscription level has a Kit Tag ID configured, that tag is applied.
  • Subscription updated — When a Stripe subscription is updated to an active status, the plugin matches the Stripe plan to a Leaky Paywall subscription level and applies the corresponding Kit tag.
  • Subscription cancelled — The plugin performs the action configured in the Cancel Action setting.
  • Failed payment — The plugin performs the action configured in the Failed Payment Action setting. This covers failed charges, failed payment intents, and failed invoice payments from both Stripe and PayPal.

Common Use Cases

  • Targeted newsletters — Tag premium subscribers differently from basic subscribers so you can send exclusive content to paying readers.
  • Win-back campaigns — Set the Cancel Action to "Add Cancel Tag" and create a Kit automation triggered by that tag to send a re-engagement email sequence.
  • Payment recovery — Set the Failed Payment Action to "Add Failed Payment Tag" and create a Kit automation to notify subscribers to update their payment method.
  • Onboarding sequences — Set up a Kit automation triggered by a subscription level tag to welcome new members with a drip email series.

Troubleshooting

  • Subscribers not syncing to Kit — Verify your API key is correct on the Kit settings page. Check that your Kit tags are displaying on the settings page — if not, the API connection is failing. Review the Leaky Paywall log for entries prefixed with "lp kit error".
  • Tags not being applied — Confirm you've entered the correct numeric Tag ID (not the tag name) in the subscription level settings. Make sure the tag exists in your Kit account.
  • Cancel or failed payment actions not working — Make sure the action is not set to "Do Nothing". If using a tag action, verify the tag ID is entered in the corresponding field. Check the Leaky Paywall log for any error entries.

Still need help? Contact Us Contact Us