> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connect.fastenhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reference

> Configuration options, events, and styling guidance for the Stitch React Native SDK

> [!NOTE]
>
> This documentation is for [Stitch.js (v5) SDK](https://docs.connect.fastenhealth.com/stitch/v5/), which is now the recommended version for integrating Fasten Connect into your application.
> If you need access to the previous versions, please see [v1 documentation](https://docs.connect.fastenhealth.com/stitch/v1/), [v3 documentation](https://docs.connect.fastenhealth.com/stitch/v3/) or [v4 documentation](https://docs.connect.fastenhealth.com/stitch/v4/).
>
> This version includes compatibility with additional runtime environments (Web, React Native, React etc), improved performance, and additional features.
>
> v5 is backwards compatible with v3 and v4 -- there are no breaking changes to the public API, but we have made significant improvements to the underlying codebase and architecture. If you are currently using v3 or v4 you can upgrade to v5 without making any changes to your code.
>
> The [v1 Web Component](https://docs.connect.fastenhealth.com/stitch/v1/), [v3 Web Component](https://docs.connect.fastenhealth.com/stitch/v3) and [v4 Web Component](https://docs.connect.fastenhealth.com/stitch/v4) are in maintenance mode and will no longer receive updates (outside of security fixes).
> Please update your code to use the new version.

```tsx theme={null}
import { FastenStitchElement } from 'fasten-connect-stitch-react-native';

const CUSTOMER_PUBLIC_ID = 'public_test_...';

export const ConnectScreen = () => (
  <FastenStitchElement
    publicId={CUSTOMER_PUBLIC_ID}
    email="patient@example.com"
    debugModeEnabled
    onEventBus={(event: StitchEvent) => {
      console.log('Fasten event', event);
    }}
  />
);
```

**publicId** `string` *required*

This must be your API public ID. You can find it in your [Fasten Connect Portal](https://portal.fastenhealth.com).

**reconnectOrgConnectionId** `string`

(Optional) Useful when the patient connection credentials are invalid (due to expiration or revocation). Providing this `reconnectOrgConnectionId` allows Fasten to reauthenticate the Patient and store their new credentials.
Reconnect When provided, the stitch component will skip the search step and go directly to the reauthentication step for the specified organization connection.

**externalId** `string`

(Optional) An Opaque identifier, used to identify the patient in your system. This value will be returned in the response.

**email** `string`

(Optional) The patient's email address. When provided, Fasten Connect prepopulates email fields in the TEFCA mode page, support request form, and health system request form. The patient can edit the prepopulated value before submitting a form.

**searchOnly** `boolean`

(Optional) If set to `true`, the stitch component will only show the search box and will not prompt the patient to verify their email address.

**searchQuery** `string`

(Optional) Prepopulate the search box with a query.

**showSplash** `boolean`

(Optional) Show a splash page introduces Fasten Connect and displays your privacy policy & terms to the patient before they begin the connection process.

**example**

**eventTypes** `string`

(Optional) By default the following standard events are always emitted:

* `patient.connection_pending`
* `patient.connection_success`
* `patient.connection_failed`
* `widget.complete`.

If you would like to receive the optional events listed below, you must set the `event-types` parameter to a comma-separated list of event types.

* `search.query`: This event is emitted when the patient searches for a healthcare institution in the Fasten Connect catalog.

**onEventBus** `callback`

(Optional/Recommended) This callback is called whenever the Stitch component emits an event. The callback receives a fully-parsed JSON object containing the event data.

**tefcaMode** `boolean`

(Optional) If set to `true`, the stitch component will operate in TEFCA IAS mode, which is a streamlined experience designed to simplify medical record collection.
In this mode, the patient will be able to verify their identity and pull medical records from healthcare institutions that participate in the TEFCA network, with minimal friction.
See the [TEFCA IAS documentation](https://docs.connect.fastenhealth.com/guides/tefca-ias.md) for more information on this experience and its benefits.

## Events

The Stitch React Native SDK emits client-side events that can be listened to in your React Native application.
The events are emitted on via the `onEventBus` callback you can pass to the `FastenStitchElement` component. The callback receives a fully-parsed JSON object containing the event data.

```ts theme={null}
onEventBus={(event: StitchEvent) => {
  console.log('Fasten event', event);
}}
```

See the [Events section of the documentation](https://docs.connect.fastenhealth.com/stitch/v5/client-events.md) for more information on the events emitted by the Stitch SDK and their payloads.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.