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

# Concepts

> Core concepts behind Junction Connect, including orgs, teams, members, users, and integration-managed members.

> [card]
>
> Interested in this feature? Get in touch with your Customer Success Manager.

## Preface

Junction Connect helps you integrate Junction Dashboard features into your web application.

To facilitate this, Junction Connect makes a few assumptions:

1. You programmatically manage the profiles of the providers as [integration-managed members](#integration-managed-members).
2. An integration-managed member must be at least a **team admin** of the team for Junction Connect to work.

What *provider* means in your use case may differ. Here are two example mappings for your consideration:

> [accordion] I am a health care practice...
>
> | Junction noun | Synonym | Meaning | API |
> | - | - | - | - |
> | Org | - | Your business entity. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | Team | - | A division in your Junction organization, containing an isolated pool of *users*. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | Member Org Admin | Staff | Your members of staff. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | Member Team Admin | Provider 📍 | Your members of staff, with access restricted to a specific set of *teams*. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | User | Patient | An end user of the device and lab testing services; belongs to a *team*. | [Junction API](https://docs.junction.com/api-details/junction-api.md) |

> [accordion] I am an EMR...
>
> | Junction noun | Synonym | Meaning | API |
> | - | - | - | - |
> | Org | - | Your business entity. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | Team | - | A customer of yours. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | Member Org Admin | - | Your own members of staff. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | Member Team Admin | Provider 📍 | A customer's members of staff. | [Management API](https://docs.junction.com/api-details/junction-management-api.md) |
> | User | Patient | An end user of the device and lab testing services; belongs to a *team*. | [Junction API](https://docs.junction.com/api-details/junction-api.md) |

## Core flow

**1. Prepare identity and team records**

Use the Junction Management API to create or resolve the team and integration-managed member for the current provider.

**2. Create a Dashboard URL**

Call [Create Dashboard URL](https://docs.junction.com/api-reference/org-management/connect/create-dashboard-url.md) with the target member, team, modality, feature, and environment.

**3. Launch Junction Connect**

Open the returned Dashboard URL in a top-level browser context for Link Out, or load it in an iframe for Feature Embed.

```mermaid theme={null}
sequenceDiagram
    autonumber
    participant PartnerApp as Your Web App
    participant PartnerBackend as Your Backend
    participant API as Junction Management API
    participant Junction as Junction Web App

    PartnerApp->>PartnerBackend: Request dashboard URL
    PartnerBackend->>API: POST /v1/org/{org_id}/ehr_integration/create_dashboard_url
    API-->>PartnerBackend: Dashboard URL
    PartnerBackend-->>PartnerApp: Dashboard URL
    PartnerApp->>Junction: Open URL
    Junction->>Junction: Configure session and route to feature
```

## Configuration

You can configure Junction Connect either through ["Org Config → Junction Connect"](https://app.junction.com/org/ehr-integration) in the Junction Dashboard, or programmatically via the [Set Junction Connect Configuration](https://docs.junction.com/api-reference/org-management/connect/set-configuration.md) endpoint on the Junction Management API.

| Setting | Description |
| - | - |
| Unique slug | A unique kebab-case slug that identifies your organization, e.g., `my-clinical-practice`. Your [Fast Launch](https://docs.junction.com/connect/fast-launch.md) subdomain is based on this slug. |
| Modalities | The Junction Connect modalities you intend to use: `link_out`, `feature_embed`, both, or none. |
| Allowed origins | Origins allowed to launch Link Out or Feature Embed sessions. For each origin, you may optionally specify a publicly accessible [Session Continuation URL](https://docs.junction.com/connect/session-continuation.md). If this is left unspecified, [Fast Launch](https://docs.junction.com/connect/fast-launch.md) will not work, and Junction Connect will show an error screen when it encounters a launch error or an irrecoverable client session. |

## Integration-managed members

To launch Junction Connect in either modality, identify the provider who should use Junction Dashboard as an integration-managed member.

These members are created and managed through the Junction Management API by your backend system.

Integration-managed members:

* can sign in only through Junction Connect launch flows;
* cannot sign in through Junction Dashboard identity providers; and
* can be assigned team role bindings when created or updated.

## Feature slug

[Features](https://docs.junction.com/connect/overview.md#features) are represented by a **feature slug**.

Use a feature slug when you:

* create a pre-authorized [Dashboard URL](https://docs.junction.com/api-reference/org-management/connect/create-dashboard-url.md);
* assemble a [Fast Launch URL](https://docs.junction.com/connect/fast-launch.md); or
* handle a [Session Continuation request](https://docs.junction.com/connect/session-continuation.md) from Junction Connect.


## Related topics

- [Introduction](https://docs.junction.com/lab/overview/introduction.md)
- [Junction API](https://docs.junction.com/api-details/junction-api.md)
- [Compendium Search](https://docs.junction.com/lab/overview/compendium-search.md)
- [Redraws](https://docs.junction.com/lab/workflow/redraws.md)
- [Proxy Ordering Registrable Test Kits](https://docs.junction.com/lab/workflow/registrable-testkit-proxy-inventory-workflows.md)


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