Skip to main content
The Suki Web SDK lets you add Suki’s clinical experiences to your JavaScript or React application using pre-built UI components. Instead of building the clinician-facing experience yourself, you embed the SDK and integrate it with your application’s existing workflow. Your application initializes the SDK, provides authentication and context, and responds to events and callbacks. The SDK provides the Suki UI and workflow, while your application controls what happens before and after the workflow, including handling the resulting data and writing it back to your EHR when applicable.
Are you a Suki partner?To use any Suki API or SDK, you must be a Suki partner. Contact the partnership team to begin the onboarding process. They help you set up your authentication system and get started with the Suki APIs and SDKs.

Get started

Confirm requirements, install the SDK, authenticate, and run your first Ambient session.

Introduction

Learn how the Web SDK works and when to use it in your application

Prerequisites

Confirm Partner credentials, browser support, and setup requirements before you install

Install the SDK

Install the JavaScript or React package and add the SDK to your application

Authenticate

Learn how Partner Tokens and provider identity work in the Web SDK

Run Your First Session

Initialize, mount, and run an Ambient session end to end

Choose a workflow

Choose the clinician workflow you want to add first. Use Ambient to capture visits. Add Dictation or Form filling when your application needs those flows.

Ambient

Learn how Ambient sessions capture conversations and generate clinical notes

Dictation

Use built-in Dictation while clinicians create or edit notes

Form Filling

Capture structured medical form data with Form filling in the Web SDK

Build and customize

After your workflow is running, wire the session lifecycle, handle note submission, and adapt the UI to your application.

Create Session

Create an Ambient session, start recording, and pass encounter context

Session Status and Events

Track session lifecycle, status, and events during an Ambient session

Note Management

Review, edit, and submit notes, then write content back to your EHR

Dictation for JavaScript

Add Dictation to a JavaScript Web SDK integration

Dictation for React

Add Dictation to a React Web SDK integration

Form Filling for JavaScript

Add Form filling to a JavaScript Web SDK integration

Form Filling for React

Add Form filling to a React Web SDK integration

Branding and Layout

Customize theme and layout options for the Web SDK UI

Minimized Layout

Embed a compact Web SDK layout when space in your UI is limited

Minimized Layout Implementation

Implement the minimized layout in your application

Features

Add these capabilities when your Ambient workflow needs more clinical depth, care settings, or session reliability.

Medication Orders

Capture medication order content from Ambient sessions in the Web SDK

Problem-Based Charting

Pass problem context so Ambient notes organize findings around diagnoses

Interoperability

Continue the same clinical note across Ambient APIs, Mobile SDK, and Web SDK

Multilingual Sessions

Configure language options for Ambient sessions in the Web SDK

Telehealth

Use the Web SDK in telehealth workflows

Session Recovery

Recover or continue an Ambient session when recording is interrupted

Offline Mode

Buffer audio during network interruptions and sync when connectivity returns

API reference

Use the API reference when you need exact types, methods, or component contracts. For React, start with Hooks, Providers, and Components. For JavaScript, start with Classes and Functions. Types apply to both.

Types

Browse Web SDK types for initialization, data models, and events

Hooks

Use React hooks for Ambient, auth, and session workflows

Providers

Wrap your application with Web SDK providers for React integrations

Components

Use Web SDK UI components in React applications

Functions

Call Web SDK functions for mount, session control, and configuration

Classes

Use Web SDK classes in JavaScript integrations

Resources

Use these resources when you need examples, tutorials, troubleshooting help, release details, or support for an existing integration.

Examples

Browse Web SDK examples for common integration patterns

React Tutorial

Build an Ambient session with the Web SDK in React

PBC Tutorial

Build Problem-Based Charting with the Web SDK

Error Handling

Handle Web SDK errors during initialization, sessions, and submission

Token Refresh

Keep Partner Tokens valid during long-running Web SDK sessions

FAQs

Find answers to general, technical, implementation, and onboarding questions

Changelog

Track Web SDK releases, enhancements, and breaking changes

Migration Guides

Upgrade an existing Web SDK integration to a newer version

Support

Contact Suki for partner documentation and SDK support

Last modified on August 13, 2026