# User Intuition

- [Welcome to User Intuition](https://docs.userintuition.ai/introduction/welcome.md): User Intuition is an AI-moderated research platform. Run interviews, concept tests, and prototype tests at scale, and turn the conversations into insight you can act on.
- [Quickstart Guide](https://docs.userintuition.ai/getting-started/quickstart.md): Launch your first research study in about 15 minutes. This guide walks you through the essential steps to go from zero to collecting insights.
- [Key Concepts](https://docs.userintuition.ai/getting-started/key-concepts.md): Understand the core concepts behind User Intuition: studies, interviews, the moderator, and the Intelligence Hub — and how they fit together.
- [Interview Modes](https://docs.userintuition.ai/getting-started/interview-modes.md): Interviews run as chat, voice, or video. How the three differ in what they capture, what participants have to allow, and what they cost.
- [Study Types](https://docs.userintuition.ai/study-types/overview.md): User Intuition offers three study types — in-depth interviews, concept tests, and prototype tests. How to pick the right one.
- [In-depth Interview](https://docs.userintuition.ai/study-types/in-depth-interview.md): A focused conversation about what someone did, why they did it, and what they would change. No stimulus required.
- [Concept Test](https://docs.userintuition.ai/study-types/concept-test.md): Show participants an image or video and capture their reaction, with the moderator probing on what they say.
- [Prototype Test](https://docs.userintuition.ai/study-types/prototype-test.md): Watch people work through your prototype or live site while they narrate their thinking, with clicks and interactions captured for replay.
- [Creating a Study Overview](https://docs.userintuition.ai/creating-a-study/overview.md): How to create a research study in User Intuition — six setup steps, then inviting participants from your dashboard.
- [Create Study](https://docs.userintuition.ai/creating-a-study/create-study.md): Pick the study type that matches what you want to learn. There are three, and all three follow the same setup process.
- [Customize Plan](https://docs.userintuition.ai/creating-a-study/customize-plan.md): Work with Charles, our AI researcher, to design a research plan tailored to your specific context and objectives. This step ensures your study asks the right questions.
- [Review Goals](https://docs.userintuition.ai/creating-a-study/review-goals.md): Review and refine the research plan that Charles generated. This is your opportunity to make direct edits before the study goes live.
- [Setup Interview](https://docs.userintuition.ai/creating-a-study/setup-interview.md): Configure how participants will experience the interview: moderator voice, format, language, recruiting method, and screener questions.
- [Test Conversation](https://docs.userintuition.ai/creating-a-study/test-conversation.md): Experience your study from a participant's perspective before launching. This step lets you validate that the conversation flows naturally and covers the topics you need.
- [Ready to Launch](https://docs.userintuition.ai/creating-a-study/ready-to-launch.md): Review your complete study configuration and launch. Once launched, your study is live and ready to receive participants.
- [Recruiting Participants](https://docs.userintuition.ai/recruiting/overview.md): Two ways to reach participants: bring your own, or recruit from our research panel. How to choose, and what each costs.
- [Share a Study Link](https://docs.userintuition.ai/recruiting/share-link.md): Get a link to your study and send it however you like. The recommended way to reach your own participants.
- [Send Email Invites](https://docs.userintuition.ai/recruiting/invite-customers.md): Add a list of email addresses and User Intuition sends the invitations, tracking who was invited and who completed.
- [Embed the AI Widget](https://docs.userintuition.ai/recruiting/embed-widget.md): Drop a User Intuition study directly into your web app with an embeddable on-site interview widget. Install in minutes with HTML, JavaScript, or React.
- [Research Panel](https://docs.userintuition.ai/recruiting/research-panel.md): Recruit from our consumer panel of 4 million+ verified respondents across 58 countries, or commission a niche audience for people the panel can't reach.
- [Dashboard](https://docs.userintuition.ai/managing-your-study/dashboard.md): Monitor your study from the dashboard: key metrics, study status, the Invites, Calls and Reports tabs, and how to invite participants.
- [Study Actions](https://docs.userintuition.ai/managing-your-study/study-actions.md): Everything in the dashboard Actions menu, and what differs between panel studies and studies where you bring your own participants.
- [Calls & Transcripts](https://docs.userintuition.ai/results/calls-and-transcripts.md): Review completed interviews: the calls list, quality ratings, and the transcript, responses, and summary for every conversation.
- [Understanding Reports](https://docs.userintuition.ai/results/reports.md): User Intuition automatically synthesizes your interview data into actionable reports. Learn how to generate, interpret, and use AI-powered insights.
- [Intelligence Hub](https://docs.userintuition.ai/results/intelligence-hub.md): Combine data from every study into one searchable workspace, ask questions in plain language, and generate reports and presentations from the answers.
- [MCP Server](https://docs.userintuition.ai/integrations/mcp-server.md): Let Claude, ChatGPT, and other AI agents operate User Intuition through the Model Context Protocol — create studies, check results, and manage research with natural language.
- [HubSpot](https://docs.userintuition.ai/integrations/hubspot.md): Sync HubSpot CRM contacts, companies, and deals into User Intuition and invite them to interviews directly from HubSpot record pages.
- [Shopify Integration](https://docs.userintuition.ai/integrations/shopify.md): Connect your Shopify store to User Intuition to sync customers and segments, then invite them to research interviews without leaving the Shopify Admin.
- [Stripe](https://docs.userintuition.ai/integrations/stripe.md): Connect your Stripe account to sync customers and customer cohorts into User Intuition as research participants.
- [Billing and credits](https://docs.userintuition.ai/resources/billing-and-credits.md): Manage your plan, buy credits, track usage, and configure payment methods.
- [Account settings](https://docs.userintuition.ai/resources/account-settings.md): Manage your profile, company information, API keys, and authentication tokens from your account settings.
- [Human Signal](https://docs.userintuition.ai/resources/human-signal.md): Get fast, lightweight feedback from real people on a single message, claim, or set of options — without running a full study.
- [Frequently Asked Questions](https://docs.userintuition.ai/resources/faq.md): Answers to commonly asked questions about User Intuition, from getting started to advanced features.
- [Best Practices](https://docs.userintuition.ai/resources/best-practices.md): Maximize the value of your customer research with these proven best practices for study design, participant recruitment, and insight activation.
- [How many interviews do you need?](https://docs.userintuition.ai/resources/sample-size.md): One question — how common the thing you're looking for is — and the number of interviews you need to be confident you'd hear about it.
- [Referrals](https://docs.userintuition.ai/resources/referrals.md): Invite friends to User Intuition and earn credits when they sign up and make their first payment.
- [Contact Support](https://docs.userintuition.ai/resources/support.md): Get help with User Intuition. Contact our team, access resources, and find answers to your questions.
- [User Intuition MCP Server](https://docs.userintuition.ai/mcp-server/overview.md): Give an AI agent the tools and rules to design studies, recruit participants, manage interviews, and analyze findings.
- [Quickstart](https://docs.userintuition.ai/mcp-server/quickstart.md): Connect with hosted OAuth first, or use the local stdio setup for Claude Desktop, Cursor, Claude Code, and VS Code.
- [Authentication](https://docs.userintuition.ai/mcp-server/authentication.md): Use hosted OAuth first, or ui_sk_ API keys with local stdio clients.
- [Studies](https://docs.userintuition.ai/mcp-server/tools/studies.md): 12 MCP tools for creating, customizing, fielding, and reporting on studies.
- [Participants](https://docs.userintuition.ai/mcp-server/tools/invites.md): 5 MCP tools for creating and managing BYOP participants and rewards.
- [Interviews](https://docs.userintuition.ai/mcp-server/tools/calls.md): 5 MCP tools for reading and administering interview records.
- [Configuration & catalogs](https://docs.userintuition.ai/mcp-server/tools/voice-reports.md): 5 supplemental MCP tools for languages, modes, voices, and study-type catalogs.
- [Panel reference & feasibility](https://docs.userintuition.ai/mcp-server/tools/integrations-panels.md): 4 MCP tools for panel country support and specialist feasibility review.
- [Webhooks](https://docs.userintuition.ai/mcp-server/tools/webhooks.md): Create and remove account-wide completed-interview webhooks.
- [Human Signal over MCP](https://docs.userintuition.ai/mcp-server/human-signal.md): Use the hosted MCP study and Panel tools for Human Signal workflows.
- [Study-creation playbook](https://docs.userintuition.ai/mcp-server/guides/playbook.md): Create a metadata draft, conduct the Customize Plan conversation, verify the result, and field the study safely.
- [Study setup](https://docs.userintuition.ai/mcp-server/guides/study-modes.md): Choose recruiting method, use sensible interview defaults, and select the appropriate study type before entering Customize Plan.
- [Screening respondents](https://docs.userintuition.ai/mcp-server/guides/screening.md): Describe audience criteria naturally and let Customize Plan choose canonical targeting or custom screeners.
- [Troubleshooting](https://docs.userintuition.ai/mcp-server/guides/troubleshooting.md): Resolve authentication, stale package, missing-tool, and backend-domain errors.
- [User Intuition CLI](https://docs.userintuition.ai/cli/overview.md): Call the same tools as the MCP server from a shell — 33 commands for studies, recruitment, interviews, and analysis, ready for scripts, CI, and ad-hoc debugging.
- [Quickstart](https://docs.userintuition.ai/cli/quickstart.md): Install the User Intuition CLI and make your first call in under two minutes.
- [Command Reference](https://docs.userintuition.ai/cli/commands.md): OAuth login, API-key management, discovery, and direct tool invocation from the userintuition-mcp CLI.
- [Recipes](https://docs.userintuition.ai/cli/recipes.md): Practical patterns for using the User Intuition CLI in scripts, CI, and day-to-day automation.
- [Troubleshooting](https://docs.userintuition.ai/cli/troubleshooting.md): Fixes for the most common CLI errors — missing binaries, auth failures, validation errors, and network problems.
- [User Intuition Skills](https://docs.userintuition.ai/skills/overview.md): Pre-built agent workflows for using the User Intuition MCP server safely and consistently — drop in, no glue code required.
- [Skills Library](https://docs.userintuition.ai/skills/library.md): Ready-to-use workflows verified against the 33-tool User Intuition MCP surface.
- [API Introduction](https://docs.userintuition.ai/api-reference/introduction.md): Integrate with User Intuition to manage studies, participants, interviews, and webhooks
- [List Studies](https://docs.userintuition.ai/api-reference/public-studies/list-studies.md)
- [Create Study](https://docs.userintuition.ai/api-reference/public-studies/create-study.md)
- [Create Study With Participants](https://docs.userintuition.ai/api-reference/public-studies/create-study-with-participants.md): Create a BYOP study and its participant invitations in one request.
- [Create Study And Launch Panel](https://docs.userintuition.ai/api-reference/public-studies/create-study-and-launch-panel.md): Create a study and immediately launch a panel for it, in one call. The study is created as a Panel study and the panel uses the study's interview language. Set ``panel.dry_run`` to get a cost estimate without creating or fielding anything.
- [Get Study](https://docs.userintuition.ai/api-reference/public-studies/get-study.md)
- [Customize Study Plan](https://docs.userintuition.ai/api-reference/public-studies/customize-study-plan.md): Run one resumable turn through the same planning agent and tools used by the dashboard's Customize Plan page.
- [Replace Study](https://docs.userintuition.ai/api-reference/public-studies/replace-study.md): Replace a study (RESTful PUT): the body is the full new state — fields you omit are cleared.
- [Patch Study](https://docs.userintuition.ai/api-reference/public-studies/patch-study.md): Partially update a study. Only provided fields change; screener_questions and targeting_attributes are patched independently (one doesn't wipe the other).
- [Delete Study](https://docs.userintuition.ai/api-reference/public-studies/delete-study.md)
- [List Interviews](https://docs.userintuition.ai/api-reference/public-interviews/list-interviews.md)
- [Get Interview](https://docs.userintuition.ai/api-reference/public-interviews/get-interview.md)
- [Delete Interview](https://docs.userintuition.ai/api-reference/public-interviews/delete-interview.md): Soft-delete an interview owned by the authenticated user.
- [List Participants](https://docs.userintuition.ai/api-reference/public-participants/list-participants.md)
- [Create Participants](https://docs.userintuition.ai/api-reference/public-participants/create-participants.md): Create up to 100 participants for a study in one request.
- [Get Participant](https://docs.userintuition.ai/api-reference/public-participants/get-participant.md)
- [Update Participant](https://docs.userintuition.ai/api-reference/public-participants/update-participant.md)
- [Send Participant Reward](https://docs.userintuition.ai/api-reference/public-participants/send-participant-reward.md): Send the configured incentive to a participant (BYOP studies only).
- [Generate Report](https://docs.userintuition.ai/api-reference/public-studies/generate-report.md): Analyze the study's interview transcripts and return the report.
- [Get Report](https://docs.userintuition.ai/api-reference/public-studies/get-report.md)
- [List Targeting Attributes](https://docs.userintuition.ai/api-reference/public-targeting/list-targeting-attributes.md): Catalog of panel targeting attributes, searchable by name and filterable by category.
- [Panel targeting quotas](https://docs.userintuition.ai/api-reference/panel-targeting.md): Set fixed interview targets for selected panel attribute options while leaving remaining capacity open
- [Launch Panel](https://docs.userintuition.ai/api-reference/public-studies/launch-panel.md): Launch a paid panel for a Panel-type study (use ``dry_run`` for a cost estimate).
- [List Panel Countries](https://docs.userintuition.ai/api-reference/public-panel-countries/list-panel-countries.md): Supported panel countries with their language options. Provide `language` OR `country` to filter (not both); omit both to list all.
- [Submit Feasibility Request](https://docs.userintuition.ai/api-reference/public-feasibility/submit-feasibility-request.md): Submit an audience for manual feasibility review.
- [Get Feasibility Request](https://docs.userintuition.ai/api-reference/public-feasibility/get-feasibility-request.md): Get a feasibility request by ID.
- [List Feasibility Requests](https://docs.userintuition.ai/api-reference/public-feasibility/list-feasibility-requests.md): List the current account's feasibility requests, newest first.
- [Study lifecycle](https://docs.userintuition.ai/api-reference/study-lifecycle.md): Pause, resume, or stop a study before editing an active panel.
- [Pause Study](https://docs.userintuition.ai/api-reference/public-studies/pause-study.md): Pause a study. Panel surveys, target cycles, and reward holds are preserved.
- [Resume Study](https://docs.userintuition.ai/api-reference/public-studies/resume-study.md): Resume a paused study. A preserved panel survey returns to fielding.
- [Stop Study](https://docs.userintuition.ai/api-reference/public-studies/stop-study.md): Stop panel recruitment and settle/release its active reward hold.
- [Webhooks](https://docs.userintuition.ai/api-reference/webhooks/overview.md): Receive completed-interview data at your own endpoint as soon as an interview finishes.
- [Create Webhook](https://docs.userintuition.ai/api-reference/public-webhooks/create-webhook.md)
- [Delete Webhook](https://docs.userintuition.ai/api-reference/public-webhooks/delete-webhook.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)