Skip to main content
This guide walks you through setting up Suki.js in your existing JavaScript or React application, from installation to mounting the SDK UI. What will you do
  1. Install the Suki Web SDK package for your framework (JavaScript or React)
  2. Initialize the SDK by creating a SukiAuthManager from @suki-sdk/core with your partner token and provider fields
  3. Mount the SDK UI into your application using the encounter object.
Using an AI coding tool?Copy the following prompt to add the Suki developer documentation as a skill and MCP server to your tool for better AI-assisted coding during the integration process. For all AI options (contextual menu, llms.txt, and skill.md), refer to AI-optimized documentation.

Install the Suki developer docs as a skill to get context on Suki's developer tools, APIs, and SDKs. Add the MCP server for documentation search.

Open in Cursor

​
Prerequisites

For the rest of this documentation, we assume the following setup is complete:
  • You have received your partnerId from Suki.
  • Your host URLs are on the Suki allowlist.
  • Your partner configuration in the Suki Platform points to your correct JWKS endpoint.
  • Your JWT token contains the key that you specified as your User identifier field.

​
Install the Suki SDK package

To begin, install the Suki web SDK package in your project. Choose the appropriate package based on your framework:
You must choose the appropriate package based on your framework. Refer to the Installation guide for more information.
For detailed setup instructions, refer to the Installation guide.

​
Step 1: Initialize the SDK

Initialize the Suki SDK by creating SukiAuthManager from @suki-sdk/core with the following required fields:
  • partnerId Required - Your partner ID from Suki
  • partnerToken Required - Your partner token from Suki
  • providerName Required - The full name of the provider
  • providerOrgId Required - The organization ID of the provider
Then pass this authManager into initialize() in JavaScript or init() in React. Run initialization once, usually from your app entry point, so your app can sign in to Suki and use Web SDK features.

​
Mount the SDK UI

After initializing the web SDK, you can mount the Suki UI into your application using the encounter object. This object provides patient context for ambient documentation and transcription.
Encounter and patient IDs: patient.identifier and encounter.identifier (when you set it) must each be strings at most 36 characters (). Longer values can fail during composition or ambient setup. See Patient and Encounter.
If you face any issues while mounting the SDK UI, make sure you are using the correct package and framework.

​
Next steps

Refer to our Ambient documentation guide to learn more about how to use the Suki Web SDK to create your first ambient session.
Last modified on June 12, 2026