Integrate Nava Insights through the Nava API
The Nava API is the public partner API for Nava Insights. Use it to create studies, manage participants, localize content, trigger analysis, and launch studies from your own systems.
What it is
Nava API is the public API edge for approved partners integrating with Nava Insights. It uses organization and user scoped API keys, and it follows the same study permissions and platform rules as the Nava Insights app.
What you can do
Create and update studies
Create draft studies, update metadata, and move studies through the same lifecycle states used in Nava Insights.
Manage segments and participants
Create participant segments, add participants one by one or in bulk, and keep membership in sync with your source systems.
Configure questions and localized content
Manage question sets, locales, and localized study content so each study is ready for the audiences you need to reach.
Run and inspect analysis
Read study analysis, check analysis status, and trigger new analysis runs when new eligible interviews are available.
Launch studies programmatically
Transition study status and publish studies through the API when your setup flow is complete.
Build against a versioned public contract
Use the documented `/v1` surface with interactive docs and OpenAPI, without depending on internal Nava Insights service contracts.
Typical integration flow
Create a study with `POST /v1/studies`.
Create segments and add participants from your own source system.
Configure questions, locales, and localized content.
Move the study through the required status transitions.
Launch it by creating a publication.
Webhooks for outbound events
Alongside the Nava API, Nava Insights supports outbound webhooks so your systems can react to study and interview activity without polling. Webhook configuration is managed in the Nava Insights app and complements the API-driven setup flow.
Subscribe to key study and interview events
Configure HTTPS endpoints for events such as `study.created.v1`, `study.launched.v1`, `study.closed.v1`, `interview.started.v1`, and `interview.completed.v1`.
Choose payload and delivery format
Choose between Standard Webhooks thin JSON and CloudEvents structured JSON, and pair either payload format with the supported webhook signing scheme that fits your integration.
Signed deliveries with testing and replay
Protect deliveries with signing, send test events from the Nava Insights app, inspect delivery history, and replay failed or missed sends when needed.
How to get access
Already on Nava Insights Enterprise?
Enterprise customers can create and manage API keys in the Nava Insights app under Settings → Integrations. New key secrets are shown once when created.
Open API key settings →New partner or integration?
Talk to Nava Insights about your use case, the workflows you want to automate, and whether partner access or an Enterprise plan is the right fit.
Contact Nava Insights →Authenticate every request with a bearer API key. Keep keys server-side and never send them from client-side application code.
Authorization: Bearer <YOUR_API_KEY>Why teams use Nava API
One study model across product and API
Your integration works with the same study concepts, permissions, and lifecycle behavior that teams use in the Nava Insights app.
A partner-safe public surface
The API is intentionally thin and versioned, so you integrate with a stable public contract instead of internal service details.
Docs that stay close to the live contract
Interactive Scalar docs and OpenAPI are served from the API itself, making it easier to inspect and validate the current surface.
Developer FAQ
Ready to get started?
3 interviews included free. No credit card required.