ConvertKit integration: API key auth, no Delete action (Unsubscribe only)
ConvertKit uses API-key authentication. The flow is standard, with one important platform-specific difference: ConvertKit does not support contact deletion via API. The Delete action is automatically removed from every cleanup dropdown when you connect ConvertKit, and the Disposable default action switches from Delete to Unsubscribe.
Where to find your ConvertKit API Secret
- Sign into ConvertKit.
- Click your account avatar → Account Settings → Advanced.
- Scroll to the API section. You will see two values: API Key (public, for read-only operations) and API Secret (private, needed for write operations like unsubscribing).
- Copy the API Secret — the longer of the two values.
Connecting ConvertKit
- In our dashboard, go to Bulk Upload → Connect Email Platform → ConvertKit.
- Paste the API Secret.
- Optionally name the connection.
- Click Save Connection.
The no-Delete exception
ConvertKit's API does not expose subscriber deletion. When you connect ConvertKit:
- The Delete option disappears from the Action dropdown on every category.
- The Disposable default action switches from Delete to Unsubscribe.
- If you want to fully remove subscribers from ConvertKit, you'll need to do that manually in the ConvertKit dashboard after our cleanup runs.
What you can verify
- Subscribers — the full subscriber list.
- Tagged groups — subscribers tagged with specific tags.
- Forms — subscribers who came through specific signup forms.
Clean-list defaults for ConvertKit
| Category | Enabled by default? | Default action |
|---|---|---|
| Invalid | Yes | Unsubscribe |
| Disposable | Yes | Unsubscribe (Delete unavailable on ConvertKit) |
| Catch-all | No | Keep |
| Unknown | No | Keep |
| Risky | No | Keep |
Common ConvertKit issues
"Cannot find API Secret"
Account Settings → Advanced. If you only see "API Key" but no "API Secret", scroll down — the Secret is shown below the Key. Some older ConvertKit accounts label them slightly differently; both API V3 and V4 secrets work with our integration.
"Subscribers do not show up as unsubscribed in ConvertKit"
ConvertKit processes API writes asynchronously. Give it 5-10 minutes after our cleanup completes. If subscribers are still showing as subscribed after an hour, contact support.
Cost
1 credit per subscriber verified. ConvertKit-based businesses often have well-engaged lists, so monthly verification on the entire subscriber base tends to produce high Safe rates.
Next steps
Related questions
Still stuck? Email support
