API Reference
20 articles
Integrate Koji into your workflow with our REST API, embeddable widgets, and webhooks.
Send Research Insights to Slack: Real-Time Customer Interview Notifications via Webhooks
Pipe customer interview insights from Koji into your Slack workspace in real time. Use Koji webhooks to notify a #research channel the moment an interview completes, post quote highlights to #product-feedback, or alert #cs-alerts when a churn signal is detected. Step-by-step setup with a working Slack incoming webhook recipe.
Connect Koji to n8n: Build Self-Hosted Customer Research Pipelines
Wire Koji into n8n via webhooks and the REST API to build self-hosted pipelines that route every completed interview into Notion, Linear, Slack, your CRM, or any other system — without sending data through a third-party automation cloud.
Amplitude + Koji: Trigger AI Interviews from Product Analytics and Pipe Insights Back as Events
How to close the loop between Amplitude product analytics and Koji AI interviews — fire interview links to users in specific Amplitude cohorts, and pipe interview themes, sentiment, and quality scores back into Amplitude as user properties and custom events.
Sync Koji AI Interviews to Salesforce: Customer Insights on Every Account, Contact, and Opportunity
Push interview transcripts, AI themes, sentiment, and quality scores from Koji into Salesforce in real time using webhooks and the Salesforce REST API — so account executives, customer success managers, and revenue ops teams act on customer evidence inside the CRM they already live in.
Sync Koji Research Insights to Notion: Build a Self-Updating Research Repository
Connect Koji to Notion via Zapier (or webhook) so every completed AI interview becomes a fresh Notion page — with transcript, structured answers, themes, quality score, and AI summary attached. Build a research repository that updates itself.
Send Koji Insights to Linear: Auto-File Engineering Tickets from Customer Interviews
Wire Koji to Linear so every customer interview that surfaces a real pain point auto-creates a tagged Linear issue — with verbatim quote, theme, study link, and quality score attached. Replace the Slack-thread-to-screenshot-to-ticket workflow with a webhook.
Connect Koji to Zapier: Automate Customer Research Workflows in Minutes
Route every completed AI customer interview from Koji into 6,000+ Zapier apps — including Notion, Linear, Salesforce, Airtable, and Gmail. A step-by-step integration guide.
API Authentication
Learn how to authenticate with the Koji API using API keys and Bearer tokens.
Sync Koji Customer Interviews to HubSpot: Live Insights on Every Contact
Push Koji interview transcripts, themes, and quality scores onto HubSpot contact and company records in real time using webhooks and the HubSpot API.
User Research API: Embed AI Interviews into Any Product or Workflow
How to use Koji's User Research API to run AI-moderated interviews from your own backend. Covers REST endpoints, the embed widget, webhooks, authentication, rate limits, and headless interview patterns.
Starting Interviews via API
Use the POST /start endpoint to programmatically launch interviews from your application.
Sending Messages via API
Understand how messages flow between your application and Koji during an API-started interview.
Completing Interviews via API
Use the POST /complete endpoint to finish an interview session and trigger automatic analysis.
Research Automation: How to Build Real-Time Research Pipelines with Webhooks
Koji webhooks push interview and report data to your systems the instant something happens — enabling Slack alerts, CRM sync, automated tagging, and fully automated research pipelines that operate without manual intervention.
Webhook Setup
Receive real-time notifications when interviews complete and analysis finishes using webhooks.
Embed Widget Reference
Technical reference for the Koji embed widget including iframe parameters and PostMessage API.
Rate Limits and CORS
Understand how Koji's API rate limiting works and how to configure CORS origins for your integration.
Mixpanel + Koji: Trigger AI Interviews from Product Events and Pipe Insights Back as Properties
Trigger Koji AI-moderated interviews from Mixpanel cohorts and behavior, then pipe themes, sentiment, and quality scores back into Mixpanel as events and user profile properties.
Intercom + Koji: Run Deep AI Interviews From Your Support and Messaging Workflows
Trigger Koji AI-moderated interviews from Intercom conversations, post-resolution surveys, and outbound messages — then sync themes, sentiment, and quality scores back as Intercom user attributes.
Jira + Koji: Auto-File Customer-Research-Backed Tickets and Close the Loop on Every Fix
Send Koji AI interview themes, customer quotes, and quality scores directly into Jira as fully-formed tickets — and pipe Jira ticket resolution back to the participants who reported it.