API Reference
39 articles
Integrate Koji into your workflow with our REST API, embeddable widgets, and webhooks.
Confluence + Koji: Publish Living Research Pages the Whole Org Can Actually Find
How to publish Koji AI interview findings into Confluence as pages that stay current, including what belongs in Confluence and what should stay in Koji.
Airtable + Koji: Launch AI Interviews from a Base and Sync Every Insight Back to the Record
Turn any Airtable base into a customer research engine: trigger Koji AI-moderated interviews from a view or automation, then write themes, sentiment, quality scores, and a transcript link straight back onto the matching record. No native connector required: Airtable speaks Zapier, Make, and outbound webhooks, and all three can call Koji's REST API.
Productboard + Koji: Turn AI Interview Insights Into Roadmap Evidence Automatically
How to push grounded customer quotes from Koji AI interviews into Productboard as insights, so every roadmap item traces back to something a real customer said.
Send Research Insights to Slack: Real-Time Customer Interview Notifications via Webhooks
Get customer interview insights from Koji into your Slack workspace. There is no native Slack app and Koji has no outbound webhooks, so you either paste the study's public report link into a channel, or have your own backend, Zapier, n8n or Make poll the Koji read API and post to a Slack incoming webhook. Step-by-step setup with a working recipe.
Connect Koji to n8n: Build Self-Hosted Customer Research Pipelines
Wire Koji into n8n with 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.
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 with a scheduled worker on the Koji read API 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.
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.
Microsoft Teams + Koji: Post AI Interview Insights Into the Channel Where Decisions Get Made
How to pipe completed Koji AI interviews into Microsoft Teams using the Workflows webhook that replaced the retired Office 365 connector, with the exact payload fields available.
Miro + Koji: Take AI-Clustered Themes Straight Onto an Affinity Board
How to move Koji AI interview themes and verbatim quotes into Miro as sticky notes, and which parts of affinity mapping are now redundant.
Sync Koji Research Insights to Notion: Build a Self-Updating Research Repository
Connect Koji to Notion via Zapier (or the API) 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.
Building with AI: the Koji API for LLMs and coding assistants
A complete, copy-paste starting point for building Koji integrations with an AI coding assistant, plus the MCP server for agentic workflows.
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 Zapier schedule that polls the Koji API.
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.
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 using the Koji API and the HubSpot API.
API Authentication
How Koji Headless API authentication works: pk_live_ API keys, permissions, session tokens, and origin allowlists.
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, how to get completion signals without webhooks, authentication, rate limits, and headless interview patterns.
API Key Permissions
The four Koji API key permissions in depth, with least-privilege key recipes for client-side and server-side integrations.
Starting Interviews via API
Create interview sessions programmatically with POST /interviews/start: request fields, the 201 response, CRM linking, and voice mode.
Sending Messages via API
Send respondent messages to POST /interviews/{id}/message and parse the Server-Sent Events reply stream frame by frame.
Completing Interviews via API
Finalize interviews with POST /interviews/{id}/complete, then poll the read endpoint for the asynchronous AI analysis.
Research Automation: How to Build Real-Time Research Pipelines with Webhooks
Build automated research pipelines on the Koji API today: event-triggered interviews, completion detection, and insight routing, no native webhooks required.
Webhook Setup
Koji has no native outbound webhooks yet. Three working alternatives: polling the read endpoint, embed completion events, and automation platforms.
Embed Widget Reference
Embed the Koji interview widget with an iframe: URL parameters, koji:* postMessage events, React integration, and prefilled respondents.
Rate Limits and CORS
Per-key rate limits, X-RateLimit headers, 429 handling with backoff, quota errors, and how CORS works on the Koji API.
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.
Segment + Koji: Trigger AI Interviews from CDP Audiences and Sync Insights Back as Traits
Use Segment Audiences and events to trigger Koji AI-moderated interviews, then pipe themes, sentiment, and quality scores back into Segment as track events and user traits that fan out to every downstream tool.
Zendesk + Koji: Trigger AI Interviews from Support Tickets and Sync Insights Back to Every Conversation
Use Zendesk triggers and webhooks to launch Koji AI-moderated interviews from solved tickets, low CSAT, or specific tags, then have a small scheduled worker poll Koji and post themes, sentiment, and a transcript link back onto the ticket automatically.
Google Sheets + Koji: Launch AI Interviews from a Spreadsheet and Auto-Log Every Insight Back
Turn a Google Sheet of contacts into a batch of Koji AI interviews, and auto-append every completed interview's themes, sentiment, quality score, and transcript link back to a live results tab — no data stack required.
Connect Koji to Make (Make.com): Build No-Code Customer Research Automations
Use Make (formerly Integromat) scenarios to trigger Koji AI interviews from any app and route themes, sentiment, and transcripts to Slack, Notion, your CRM, or a spreadsheet, no code, using HTTP and Schedule modules.
Attio + Koji: Launch AI Interviews from Your CRM and Sync Every Insight Back to the Record
Connect Attio to Koji to trigger AI customer interviews from CRM records and lists, then write themes, quotes, and structured scores back onto each contact and company automatically.
Klaviyo + Koji: Turn Post-Purchase and Win-Back Flows into AI Customer Interviews
Connect Klaviyo to Koji to trigger AI voice and text interviews from email and SMS flows and segments, then sync themes and structured scores back to Klaviyo profiles for sharper segmentation.
Calendly + Koji: Auto-Run AI Interviews After Every Demo, Call, and No-Show
Connect Calendly to Koji to trigger AI voice and text interviews from meeting events — post-demo, post-onboarding, and no-show follow-ups — and capture structured feedback automatically.
Mailchimp + Koji: Turn Email Journeys and Audiences into AI Customer Interviews
Connect Mailchimp to Koji to trigger AI voice and text interviews from Customer Journeys, tags, and segments, then sync themes and structured scores back to Mailchimp merge fields for sharper audience targeting.
Pipedrive + Koji: Turn Deal Stages into AI Win-Loss and Post-Demo Interviews
Connect Pipedrive to Koji to trigger AI voice and text interviews when deals are won, lost, or move stage, then sync themes and structured scores back to Pipedrive deal fields for a continuous win-loss program.
PostHog + Koji: Turn Funnels and Cohorts into AI User Interviews
Connect PostHog to Koji to trigger AI voice and text interviews from cohorts, funnels, and events, then sync the "why" behind your metrics back as themes and structured scores. PostHog tells you what happened; Koji tells you why.
monday.com + Koji: Turn Board Automations into AI Customer Interviews
Connect monday.com to Koji to trigger AI voice and text interviews from board status changes and CRM pipeline stages, then sync themes and structured scores back into monday columns to close the feedback-to-roadmap loop.
Customer Research in Your Data Warehouse: Modelling Interview Data for Snowflake, BigQuery, and BI
A practical schema and loading pattern for getting AI interview data into Snowflake, BigQuery, Redshift, or Postgres — and the four dashboards worth building in Looker, Tableau, Power BI, or Metabase once qualitative themes sit next to revenue and product events.