New

Now in Claude, ChatGPT, Cursor & more with our MCP server

Back to docs

API Reference

12 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 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.

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.

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.