feat: new guide - Connect Loops to Kinde#663
Merged
tamalchowdhury merged 9 commits intomainfrom Feb 13, 2026
Merged
Conversation
This comment was marked as resolved.
This comment was marked as resolved.
Contributor
|
Important Review skippedThis PR was authored by the user configured for CodeRabbit reviews. By default, CodeRabbit skips reviewing PRs authored by this user. It's recommended to use a dedicated user account to post CodeRabbit review feedback. To trigger a single review, invoke the You can disable this status message by setting the Use the checkbox below for a quick retry:
WalkthroughAdds a new MDX documentation page describing how to connect Kinde webhooks to Loops via Zapier (Catch Raw Hook → Code action to decode JWT → Loops API create/update contact), and updates two existing webhook docs to reflect payload field changes. Changes
Sequence Diagram(s)sequenceDiagram
participant Kinde as Kinde (Webhook)
participant Zapier as Zapier (Catch Raw Hook)
participant Code as "Zapier Code Action\n(JWT decode)"
participant Loops as Loops API
Kinde->>Zapier: POST webhook (payload with JWT)
Zapier->>Code: Forward raw payload
Code->>Code: Decode JWT, extract user fields
Code->>Zapier: Return parsed JSON
Zapier->>Loops: Create/Upsert contact via API (API key auth)
Loops-->>Zapier: 200 OK / contact ID
Zapier-->>Kinde: (optional) acknowledge / log
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Poem
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. Comment |
Deploying kinde-docs-preview with
|
| Latest commit: |
6273ea8
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://42ab368e.kinde-docs-preview.pages.dev |
| Branch Preview URL: | https://tamal-feat-kinde-and-loops-i.kinde-docs-preview.pages.dev |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Fix all issues with AI agents
In `@src/content/docs/integrate/third-party-tools/kinde-loops.mdx`:
- Around line 108-140: The snippet decodes JWTs but never verifies the
signature, so update the documentation snippet and surrounding text to instruct
callers to validate the webhook JWT before trusting payload fields: add guidance
around the decodeJWT usage to verify the token signature (e.g., using the JWT
library or Kinde's public key/ JWKS) and show where to perform verification
(before using decoded from decodeJWT), reference the decodeJWT function and the
jwt/inputData variable so readers know to replace the simple decoder with a
verification step or call a verify method that checks signature, issuer,
audience, and expiration according to Kinde webhook security guidance.
Contributor
There was a problem hiding this comment.
Actionable comments posted: 4
🤖 Fix all issues with AI agents
In `@src/content/docs/integrate/third-party-tools/kinde-loops.mdx`:
- Around line 204-207: The instructions ask users to convert users.ndjson to CSV
but give no guidance; update the step that currently reads "Create a new `.csv`
file with the following columns: `First Name`, `Last Name`, `Email`, `User
Group`" (step 7) to include a short, beginner-friendly conversion option:
provide a one-paragraph example approach and a recommended tool—either (a) a
tiny shell/Python snippet that parses users.ndjson and writes those CSV columns
(showing the expected JSON keys to map to First Name/Last Name/Email/User
Group), or (b) a link to a trusted online NDJSON→CSV converter and brief
instructions on selecting/mapping fields—so readers know exactly how to produce
the CSV from users.ndjson before proceeding to the Import CSV step.
- Around line 126-139: The code assumes decoded.data exists before accessing
decoded.data.user, which can throw a TypeError; update the decoding logic
(around decodeJWT and the userData assignment) to guard against missing payloads
by using a safe access pattern (e.g., check decoded && decoded.data or use
optional chaining) so userData becomes decoded?.data?.user || {} (or equivalent)
and ensure the returned fields use that fallback to avoid runtime errors when
decoded.data is undefined.
- Line 41: Remove the incorrect plan requirement text from the Zapier bullet:
delete the phrase "Professional plan or higher required for webhook triggers"
(the Zapier list item currently reads "A [Zapier](https://zapier.com/) account
(Professional plan or higher required for webhook triggers)") and replace it
with a neutral statement such as "A [Zapier](https://zapier.com/) account" so
the Zapier bullet no longer claims webhook triggers require a Professional plan.
- Around line 128-139: The webhook handler currently reads email from
userData.email (the decoded payload) which Kinde's user.created event doesn't
include, so update the logic in the function that builds the returned object
(the block that reads userData and returns
firstName/lastName/email/fullName/userId/orgCode/rawData) to obtain email either
by extracting it from another payload location (e.g.,
decoded.data.user.identities or decoded.data.user_details if present) or, if
absent, call the Kinde Management API to fetch the full user record using
userData.id (or the returned userId) before returning the object; ensure the
returned email field is populated with the fetched/derived value and that any
new network call is handled asynchronously and errors are logged/propagated
rather than silently defaulting to ''.
🧹 Nitpick comments (1)
src/content/docs/integrate/third-party-tools/kinde-loops.mdx (1)
161-161: Minor: Inconsistent UI action verb.This line uses "Click" while every other UI instruction in the document uses "Select" (e.g., lines 46, 47, 53, 54, 55, etc.). For consistency:
- - Click **Sign in to Loops** + - Select **Sign in to Loops**
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Fix all issues with AI agents
In `@src/content/docs/integrate/third-party-tools/kinde-loops.mdx`:
- Around line 283-285: The code block contains a typo: the shell command
"python3 python convert_users_to_csv.py" includes an extra "python" token;
update the code block in
src/content/docs/integrate/third-party-tools/kinde-loops.mdx to use a valid
command such as "python3 convert_users_to_csv.py" (or "python
convert_users_to_csv.py") so the copy-pasted command runs correctly.
🧹 Nitpick comments (1)
src/content/docs/integrate/third-party-tools/kinde-loops.mdx (1)
161-161: Minor terminology inconsistency: "Click" vs "Select".The rest of the document consistently uses "Select" for UI actions. Consider changing "Click" to "Select" here for consistency.
📝 Proposed fix
- - Click **Sign in to Loops** + - Select **Sign in to Loops**
Contributor
There was a problem hiding this comment.
Actionable comments posted: 2
🤖 Fix all issues with AI agents
In `@src/content/docs/integrate/third-party-tools/kinde-loops.mdx`:
- Line 169: Update the documentation entry for the Subscribed default to include
a brief compliance/consent note: mention that setting "Subscribed" (or
`subscribed`) to true auto-opt-ins users to marketing emails and that under
GDPR/CAN-SPAM a legal basis (explicit consent) is typically required, advise
adding copy at signup to capture consent or defaulting `subscribed` to false and
implementing a double opt-in flow, and suggest logging/storing the user's
consent timestamp and source for auditability.
- Around line 128-139: The returned payload mapping currently pulls user fields
from userData (decoded.data.user), but Kinde docs show email may instead be at
decoded.data.email; update the mapping for email (and other user fields as
needed) to defensively check both locations (e.g., prefer
decoded.data.user.email but fallback to decoded.data.email), and apply the same
dual-source fallback for firstName/lastName/fullName/userId/orgCode so the
returned properties (firstName, lastName, email, fullName, userId, orgCode,
rawData) always resolve whether the webhook provides data under
decoded.data.user or directly under decoded.data; ensure trimming and
empty-string fallbacks are preserved.
Contributor
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Fix all issues with AI agents
In `@src/content/docs/integrate/third-party-tools/kinde-loops.mdx`:
- Line 76: Update the UI label text in the sentence currently reading "Select
**Add event** to select which events you want to trigger this webhook" so it
matches the Mailgun doc's wording by changing "**Add event**" to "**Add
Events**"; locate the exact string "Select **Add event** to select which events
you want to trigger this webhook" in the Kinde Loops integration doc and replace
it with "Select **Add Events** to select which events you want to trigger this
webhook" to ensure consistent wording across docs.
🧹 Nitpick comments (1)
src/content/docs/integrate/third-party-tools/kinde-loops.mdx (1)
20-20: Consider changing complexity tointermediate.The guide involves JWT token decoding in a Zapier Code action and a Python script for NDJSON-to-CSV conversion. These tasks go beyond beginner-level and are more aligned with
intermediatecomplexity, consistent with the Mailgun guide which is also taggedintermediate.
onderay
approved these changes
Feb 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description (required)
This doc creates a new guide, connect Loops to Kinde (via Zapier)
Related issues & labels (optional)
Summary by CodeRabbit