> ## Documentation Index
> Fetch the complete documentation index at: https://developer.suki.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suki Form Filling SDK

> Capture structured medical form data by voice with Suki's hosted iframe UI for JavaScript and React

The Suki Form filling SDK is a JavaScript and React library that lets clinicians complete medical forms by voice in your web application using Suki's hosted iframe UI. Instead of building the form-filling experience yourself, you embed the SDK and integrate it with your application's EHR handoff.

Your application initializes the SDK, authenticates, and handles submit callbacks or webhook results. The SDK provides the hosted Form filling UI, while your application controls how structured form data is mapped into your EHR. After you initialize the SDK, start a single-form or multi-form session so clinicians can complete Medical form templates by voice.

<Callout icon="handshake" color="orange">
  **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.

  <div style={{ marginTop: '0.75rem' }}>
    <a className="doc-guide-btn partner-contact-cta" href="https://www.suki.ai/suki-partners/" target="_blank" rel="noopener noreferrer">
      Contact Partnership Team
    </a>
  </div>
</Callout>

<Info>
  If your integration uses Suki's Web SDK, Form filling is **already included** in the Web SDK. Install the standalone Form filling packages only when you want Form filling without the rest of the Web SDK.
</Info>

## Get started

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

<Columns cols={3}>
  <Card title="Introduction" icon="book" href="/form-filling-sdk/introduction" arrow={true}>
    <p>Learn how the Form filling SDK works and when to use it in your application</p>
  </Card>

  <Card title="Prerequisites" icon="list-check" href="/form-filling-sdk/prerequisites" arrow={true}>
    <p>Confirm Partner credentials, templates, and setup requirements before you install</p>
  </Card>

  <Card title="Install the SDK" icon="download" href="/form-filling-sdk/installation" arrow={true}>
    <p>Install the JavaScript or React Form filling packages</p>
  </Card>

  <Card title="Authenticate" icon="key" href="/form-filling-sdk/guides/authentication" arrow={true}>
    <p>Learn how authentication works for Form filling SDK sessions</p>
  </Card>

  <Card title="Run Your First Session" icon="rocket" href="/form-filling-sdk/quickstart" arrow={true}>
    <p>Initialize, authenticate, and start a Form filling session end to end</p>
  </Card>
</Columns>

## Choose a session type

Start with one Medical form template or pass several so the clinician can select forms in the hosted UI.

<Columns cols={3}>
  <Card title="Single Form" icon="file-lines" href="/form-filling-sdk/guides/integration-patterns#single-form-session" arrow={true}>
    <p>Use one template so the clinician goes straight to recording</p>
  </Card>

  <Card title="Multi-Form" icon="files" href="/form-filling-sdk/guides/integration-patterns#multi-form-session" arrow={true}>
    <p>Pass multiple templates so the clinician picks which forms to fill first</p>
  </Card>
</Columns>

## Integrate Form filling

Embed the SDK in JavaScript or React, then configure sessions and handle how structured results return to your application.

<Columns cols={3}>
  <Card title="Session Workflow" icon="diagram-project" href="/form-filling-sdk/guides/integration-patterns" arrow={true}>
    <p>Learn how Form filling sessions start, run, and return structured data</p>
  </Card>

  <Card title="JavaScript Integration" icon="js" href="/form-filling-sdk/javaScript-integration/javaScript" arrow={true}>
    <p>Embed Form filling in vanilla JavaScript applications</p>
  </Card>

  <Card title="React Integration" icon="react" href="/form-filling-sdk/react-integration/react" arrow={true}>
    <p>Embed Form filling in React applications</p>
  </Card>

  <Card title="Configuration" icon="sliders" href="/form-filling-sdk/guides/configuration" arrow={true}>
    <p>Configure Form filling SDK options, templates, and session settings</p>
  </Card>

  <Card title="Callbacks" icon="bolt" href="/form-filling-sdk/guides/callbacks" arrow={true}>
    <p>Handle submit, error, and session events from the Form filling SDK</p>
  </Card>
</Columns>

## API reference

Look up client methods, events, and contracts when you need exact Form filling SDK surfaces.

<Columns cols={3}>
  <Card title="API Reference Overview" icon="code" href="/form-filling-sdk/api-reference/overview" arrow={true}>
    <p>Browse Form filling SDK client methods, events, and types</p>
  </Card>

  <Card title="FormFillingClient" icon="cube" href="/form-filling-sdk/api-reference/form-filling-client" arrow={true}>
    <p>Use `FormFillingClient` to start and control Form filling sessions</p>
  </Card>

  <Card title="Events" icon="bell" href="/form-filling-sdk/api-reference/events" arrow={true}>
    <p>Event names and payloads the Form filling SDK emits</p>
  </Card>
</Columns>

## Resources

Use these pages when you need examples, EHR handoff patterns, error handling, release notes, or partner support.

<Columns cols={3}>
  <Card title="Examples" icon="laptop-code" href="/form-filling-sdk/examples/basic-usage" arrow={true}>
    <p>Browse Form filling SDK examples for common integration patterns</p>
  </Card>

  <Card title="Event Handling Example" icon="bolt" href="/form-filling-sdk/examples/event-handling" arrow={true}>
    <p>See how to handle Form filling SDK events in your application</p>
  </Card>

  <Card title="EHR Handoff Example" icon="upload" href="/form-filling-sdk/examples/ehr-handoff" arrow={true}>
    <p>Map Form filling results into your EHR</p>
  </Card>

  <Card title="Webhook Handler Example" icon="webhook" href="/form-filling-sdk/examples/webhook-handler" arrow={true}>
    <p>Handle Form filling results delivered through your partner webhook</p>
  </Card>

  <Card title="Configuration Examples" icon="sliders" href="/form-filling-sdk/guides/examples/configuration-examples" arrow={true}>
    <p>Browse Form filling SDK configuration examples for common setups</p>
  </Card>

  <Card title="EHR Handoff Tutorial" icon="graduation-cap" href="/documentation/tutorials/form-filling-sdk-ehr-handoff" arrow={true}>
    <p>Build a Form filling session and hand structured results to your EHR</p>
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/form-filling-sdk/guides/error-handling" arrow={true}>
    <p>Handle Form filling SDK errors during authentication and sessions</p>
  </Card>

  <Card title="FAQs" icon="circle-question" href="/form-filling-sdk/faqs/general" arrow={true}>
    <p>Find answers to general, integration, and technical questions</p>
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="/form-filling-sdk/changelog" arrow={true}>
    <p>Track Form filling SDK releases, enhancements, and breaking changes</p>
  </Card>

  <Card title="Support" icon="life-ring" href="/documentation/references/support" arrow={true}>
    <p>Contact Suki for partner documentation and SDK support</p>
  </Card>
</Columns>