API Reference
35 articles
Integrate Koji into your workflow with our REST API, embeddable widgets, and webhooks.
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 webhooks, and Koji speaks all three.
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.
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.
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.
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.
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.
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 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
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, webhooks, authentication, rate limits, and headless interview patterns.
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.
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 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 Webhooks 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.