{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-05-22T19:58:20.228Z"},"content":[{"type":"documentation","id":"c742246a-8af8-4a18-a310-eb67adc2bf3c","slug":"managing-research-participants","title":"Managing Research Participants: The Complete Guide to Koji's Recruit Tab","url":"https://www.koji.so/docs/managing-research-participants","summary":"Koji's Recruit tab is a full participant management system for user research. It supports CSV import with personalized interview links, status tracking (completed/partial/active/archived), quality score filtering, intake form data columns, and CSV export for CRM integration and incentive distribution. Personalized links (via ?rid= parameter) tie each response to a known contact, enabling follow-up research and longitudinal tracking across multiple study waves.","content":"# Managing Research Participants: The Complete Guide to Koji's Recruit Tab\n\nWhen you run user research at scale, managing participants becomes as important as designing the interview itself. You need to know who responded, who dropped off, which responses meet your quality bar, and how to follow up with specific individuals. Koji's participant management system — accessible via the **Recruit** tab in every study — gives you a complete operational view of your respondent pool.\n\nThis guide covers every feature in the participant management workflow: from importing a list of contacts, to tracking interview status, filtering by completion, exporting for analysis, and archiving low-quality responses.\n\n## The Recruit Tab: Your Research Operations Center\n\nEvery Koji study has a **Recruit** tab that serves as the operational hub for your participant list. Here you see every person who has started or completed your interview, along with their status, intake form data, interview quality, and individual analysis.\n\nThe key columns in the participant table:\n\n- **Name / Email** — captured via the intake form or imported from CSV\n- **Status** — Active (interview in progress), Completed, Partial (started but did not finish), Archived\n- **Quality Score** — the 1–5 AI-generated quality rating for their interview\n- **Duration** — time spent in the interview from first to last message\n- **Source** — how they accessed the interview (organic link, CSV import, custom link, API)\n- **Date** — when they first started and when they completed\n- **Intake Responses** — a column for each intake form field (email, role, company, and any custom fields you configured)\n\nClick any row to open the **Analysis Drawer** — a side panel showing that participant's full interview transcript, AI insights, quality breakdown, themes, and structured question answers without leaving the participant list.\n\n## Participant Statuses Explained\n\n**Completed:** The participant finished the interview naturally (the AI concluded the conversation) or clicked Done. Koji's quality gate has evaluated their response.\n\n**Partial:** The participant started the interview but did not complete it. Their transcript may be incomplete. Partial responses are excluded from Insights Dashboard aggregations and report generation by default.\n\n**Active:** The participant is currently in an interview session, or they have an open session that has not yet timed out.\n\n**Archived:** You have manually hidden this participant from your analysis. Archived participants are excluded from reports and the default Recruit tab view. This is useful for removing test responses, bot responses, or participants who do not match your target profile. Archiving is reversible — participants can be restored at any time.\n\n## Filtering and Searching Participants\n\nUse the filter controls at the top of the Recruit tab to narrow your view:\n\n**Status filter:**\n- All\n- Completed\n- Partial\n- Active\n- Archived\n\n**Search:**\nType any name, email address, or external ID to find a specific participant. This is useful when following up with a specific customer or verifying that a particular person's interview came through correctly.\n\n**Sort by quality score:**\nSort columns to surface your highest-quality interviews first — or to identify low-quality responses that may warrant archiving before you generate a report.\n\n## [Importing Participants via CSV](/docs/importing-participants-csv)\n\nIf you have a list of participants you want to invite — from your CRM, customer database, or a recruitment panel — import them via CSV to pre-register them in Koji and generate personalized interview links for each person.\n\n### What the CSV Import Does\n\nWhen you import a CSV:\n1. Each row becomes a registered respondent record in Koji\n2. Each respondent receives a unique personalized interview URL with a `?rid=` parameter that tracks their identity\n3. Koji returns a downloadable CSV with the personalized links appended to each row\n4. You use those personalized links in your email outreach so responses are automatically attributed to the right person\n\n### CSV Format\n\nYour CSV needs at minimum:\n```\ndisplay_name, email\nJohn Smith, john@example.com\nSarah Jones, sarah@example.com\n```\n\nOptional columns you can include:\n- `external_id` — your internal ID for this person (CRM contact ID, user ID, etc.)\n- `metadata_company` — company name for B2B segmentation\n- `metadata_plan` — subscription plan for cohort analysis\n- `metadata_cohort` — study cohort label (e.g., \"q1-2025-enterprise\")\n- Any additional `metadata_*` columns with segment data you want to analyze later\n\n### Importing via the UI\n\nGo to **Recruit → Import Participants → Upload CSV**. Koji validates your file, shows a preview of the first few rows, and generates personalized links in about 30 seconds for lists up to 10,000 rows.\n\n### Importing via API\n\nFor automated pipelines — triggering an interview invite for every customer who reaches a milestone in your product, for example — use the Koji API:\n\n```\nPOST /api/v1/respondents/import\nAuthorization: Bearer YOUR_API_KEY\n\n{\n  \"respondents\": [\n    {\n      \"display_name\": \"John Smith\",\n      \"email\": \"john@example.com\",\n      \"external_id\": \"crm_12345\",\n      \"metadata\": {\n        \"company\": \"Acme Corp\",\n        \"plan\": \"enterprise\",\n        \"cohort\": \"q4-2025\"\n      }\n    }\n  ]\n}\n```\n\nThe API response includes a personalized `interview_url` for each respondent. See [Starting Interviews via API](/docs/starting-interviews-via-api) for complete documentation.\n\n## Personalized Interview Links\n\nPersonalized links are the mechanism that ties each response back to a specific known person. The link format is:\n\n```\nhttps://koji.so/i/your-study-slug?rid=RESPONDENT_ID\n```\n\nWhen a participant opens their personalized link:\n- Their name (if provided) appears in the welcome message\n- Their metadata is automatically attached to their interview record in the Recruit tab\n- Their intake form can be pre-filled with known information\n- Their response is attributed to their specific record\n\nThis is critical for several workflows:\n- **Follow-up research** — knowing which customer said what, so you can follow up intelligently\n- **CRM integration** — matching Koji responses back to your customer records via external_id\n- **Incentive distribution** — confirming exactly which participants completed the interview\n- **Longitudinal studies** — tracking the same participant across multiple research waves over time\n\n## Exporting Participant Data\n\nTo export your participant list:\n\n1. Go to the **Recruit** tab\n2. Apply any filters you need (e.g., Completed only, quality score above 3)\n3. Click **Export CSV**\n\nThe exported file includes:\n- All participant metadata (name, email, external_id)\n- Interview status and quality score\n- Interview duration and message count\n- All intake form responses (one column per field)\n- Date of first message and date of completion\n- Unique interview ID (for linking back to transcripts)\n- All custom metadata fields imported at the start\n\nCommon uses for participant exports:\n- Distributing gift cards or incentives to completers\n- Passing participant data back to your CRM\n- Joining with quantitative survey data for mixed-methods analysis\n- Compliance and research ethics documentation\n- Identifying participants with high-quality responses for follow-up depth interviews\n\n## Archiving and Managing Response Quality\n\nNot every response that comes in will meet your quality bar. Common reasons to archive a participant:\n\n- **Test responses** — your own test runs, or test responses from teammates before launch\n- **Off-target participants** — someone who does not match your screening criteria (they found the open link)\n- **Low-effort responses** — extremely short, nonsensical, or obviously automated answers\n- **Duplicate responses** — the same person who somehow submitted twice\n\nTo archive a participant: click the **...** menu on their row and select **Archive**. To restore an archived participant, switch the filter to **Archived** and click **Restore**.\n\nArchiving is fully non-destructive. The interview transcript and data are preserved — archiving only hides the response from your analysis views and report generation.\n\n## Koji's Automatic Quality Gate\n\nKoji automatically evaluates every completed interview before it counts toward your credit usage. The quality gate checks:\n\n- **Minimum engagement** — the participant must have exchanged enough messages to constitute a real conversation\n- **Response relevance** — the AI checks whether answers address the research topic\n- **Completion depth** — whether the AI was able to cover the key research questions in the brief\n\nInterviews that fail the quality gate are marked as **Not Counted** and do not consume a credit. You will still see them in the Recruit tab with a quality indicator, and you can review them to understand why they did not pass. See [How the Quality Gate Works](/docs/how-the-quality-gate-works) for full specification.\n\nThis is a meaningful advantage over traditional survey tools, where every low-effort submission counts against your budget and contaminates your data.\n\n## Participant Feedback\n\nEvery completed interview includes a simple thumbs up / thumbs down feedback prompt shown to participants at the end of their interview. This captures participant experience data — not response quality.\n\nParticipant feedback is visible in the Recruit tab via the Feedback column. A pattern of thumbs-down responses combined with low quality scores may indicate a problem with your interview design: the interview is too long, the questions are confusing, or participants are encountering technical issues.\n\n## Tracking Respondents Across Multiple Studies\n\nFor longitudinal research or multi-wave studies, you can track the same participant across multiple Koji studies using the `external_id` field:\n\n1. Import participants with the same `external_id` in each study wave\n2. After each wave, export participant data\n3. Join on `external_id` in your analysis tool (Excel, Google Sheets, your BI platform) to track how responses change over time\n\nThis enables powerful longitudinal analysis:\n- How does customer sentiment evolve from onboarding month one to month six?\n- How does product perception change between beta and general availability?\n- How do employee experience scores shift across quarterly pulse research waves?\n\n## Best Practices\n\n**Always use personalized links for targeted outreach.** Open recruitment links are fine for broad discovery research, but for any study where you need to know who said what, import participants first and use personalized links.\n\n**Archive test responses before analysis.** Run test interviews before launch — and remember to archive them in the Recruit tab afterward so they do not contaminate your Insights Dashboard or reports.\n\n**Use external_id for CRM integration.** Passing your CRM's contact ID as `external_id` makes it trivial to match Koji responses back to your customer database and enriches responses with all the CRM data you already have.\n\n**Export after each research wave.** Do not rely on the Koji UI for long-term data storage. Export participant data and transcripts regularly as part of your research data management practice.\n\n**Use metadata fields for segmentation.** Attaching cohort, plan, region, or segment metadata at import time makes post-analysis slicing much easier. You can filter the Recruit tab by these fields to compare how responses differ across sub-groups — enterprise vs. SMB, churned vs. retained, new vs. tenured customers.\n\n## Further reading on the blog\n\n- [How to Recruit User Research Participants: The Complete Guide (2026)](/blog/how-to-recruit-user-research-participants-2026) — Recruiting the wrong participants is more expensive than recruiting none at all. Here's the complete playbook: screeners, channels, incentiv\n- [Best AI Market Research Tools in 2026: The Complete Buyer's Guide](/blog/ai-market-research-tools-2026) — AI has fundamentally changed market research. This guide compares the leading AI market research platforms—from AI-native interview tools li\n- [B2B Customer Research: The Complete Guide for Product Teams (2026)](/blog/b2b-customer-research-guide-2026) — B2B customer research is harder than B2C — you are navigating buying groups of 10+ stakeholders, gatekeepers, and enterprise procurement cyc\n\n<!-- further-reading:blog -->\n","category":"Collecting Responses","lastModified":"2026-05-13T00:33:21.41039+00:00","metaTitle":"Managing Research Participants: The Complete Guide to Koji's Recruit Tab — Koji Docs","metaDescription":"How to track, import, filter, and export research participants in Koji. Covers personalized interview links, CSV import, quality management, and longitudinal tracking.","keywords":["research participant management","interview participant tracking","managing research respondents","participant management tool","research recruit tab","research CRM integration"],"aiSummary":"Koji's Recruit tab is a full participant management system for user research. It supports CSV import with personalized interview links, status tracking (completed/partial/active/archived), quality score filtering, intake form data columns, and CSV export for CRM integration and incentive distribution. Personalized links (via ?rid= parameter) tie each response to a known contact, enabling follow-up research and longitudinal tracking across multiple study waves.","aiDifficulty":"beginner","aiEstimatedTime":"10 minutes"}],"pagination":{"total":1,"returned":1,"offset":0}}