ConvertKit (Kit)
Connect ConvertKit so approved affiliates land in a Kit form automatically, with tags.
Rekomi's ConvertKit (now branded as Kit) integration subscribes every approved affiliate to a Kit form you pick. ConvertKit's data model is form-centric rather than list-centric: a subscriber joins your account by being attached to a form, then automations and sequences fire off that form.
What syncs
When an affiliate is approved (or, optionally, when they apply), Rekomi sends Kit:
emailfirst_name(split from full name)fields.last_name(when the affiliate has a full name with at least two parts)- Tags (numeric tag IDs, inline on the subscribe call)
ConvertKit's subscribe API is idempotent at the email level, re-subscribing the same email never duplicates the subscriber, it just refreshes their attributes.
Finding your API secret
In Kit:
- Click your avatar in the top right.
- Open Account Settings → Advanced.
- Scroll to the API section.
- Copy the API Secret (the longer one, used for write operations). The shorter
api_keyis read-only and won't work for Rekomi syncs.
Connecting ConvertKit in Rekomi
- Go to Integrations in the dashboard sidebar.
- Click the Kit (ConvertKit) card.
- Paste your API secret. Click Connect.
- Rekomi runs a test call against
GET /v3/accountto verify the secret. - Once connected, pick a default form from the Form dropdown. Click refresh after creating a new form in Kit.
Tags
Optional. Comma-separated. Kit's tagging model uses numeric tag IDs, not names. Find tag IDs in Kit:
- Subscribers → Tags in the Kit dashboard.
- Click a tag.
- The URL ends in the tag ID (e.g.,
/tags/1234567).
Paste the numeric IDs into Rekomi's tag field (e.g., 1234567, 9876543). Rekomi attaches them on the subscribe call.
A name-to-ID picker is on the roadmap; for now, IDs are the only supported format. The default "Rekomi affiliate" system tag is currently a string tag (not numeric) and is silently skipped on Kit until the tag-resolution UI ships.
When sync fires
- Default: only
Approvedaffiliates sync. - Optional: enable "Include applicants before approval" in Advanced to sync
Pendingaffiliates immediately on apply.
Per-campaign overrides
Each campaign can route to a different Kit form or skip Kit entirely. Open the campaign's Integrations tab to set:
- A campaign-specific form (override the account default).
- Additional tag IDs (added to whatever's set at the account level).
- A per-campaign disable toggle.
Per-affiliate sync visibility
The affiliate detail page has a CRM sync panel showing each connected CRM and the latest sync state for that affiliate. The Resync button clears prior job rows and re-fires the sync from scratch, useful after fixing a misconfigured tag ID or form selection.
Troubleshooting
- "API Secret required", You pasted the read-only
api_keyinstead ofapi_secret. Re-copy from Kit Account Settings → Advanced → API → the LONGER key. - "Form not found", The form was deleted in Kit after Rekomi cached its ID. Refresh the form picker and choose a current one.
- Tags not applying, Verify the tag IDs are numeric. String tag names won't work on v3.
A note on API versions
Kit's v3 API is officially "no longer in active development", but no sunset date has been announced. Rekomi pins to v3 because v4 historically required OAuth; v4 now supports both OAuth and API keys, so a future migration is viable without an OAuth dance. When Kit announces v3 sunset, Rekomi will migrate transparently, your stored credentials will continue to work.
Disconnecting
Click Disconnect on the Kit connect page. The integration row + any per-campaign overrides are deleted. Historical sync rows are preserved for audit.
See the convertkit integration overview on the marketing site for use-cases, persona fit, and unique automation patterns.