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

# Set up PracticeFusion with Nango

> Register an OAuth app with PracticeFusion and connect it to Nango

This guide shows you how to register your own app with PracticeFusion to obtain your OAuth credentials (client ID & secret). These are required to let your users grant your app access to their PracticeFusion practices.

**1. Complete PDS API Partner Registration**

Complete the [PDS API Partner Registration Form](https://pfpds.practicefusion.com/s/Registration) with your developer and company information. You must also agree to the Terms of Service to submit your registration as a third-party developer.

**2. Receive portal access**

Upon approval, you will receive an email with login information to the Patient Data Sharing (PDS) API portal.

**3. Complete PDS API Partner Application**

Log in to the PDS API portal, select **Application** from the navigation, and complete the PDS API Partner Application form with all required information. The information you enter will be displayed to EHR users.

Key fields to note:

* **Application type**: Choose from Patient (applications that patients can use or as an alternative to Patient Fusion) or Provider (applications that Practice Fusion users could use either as stand-alone applications, or as a module within the platform using the SMART on FHIR standard).
* **Redirect URL(s)**: Add `https://api.nango.dev/oauth/callback` as your redirect URL for Nango.
* **Launch URL(s)**: Required for provider applications that support SMART launch from within an EHR as specified in the [HL7 SMART App Launch guide](https://www.hl7.org/fhir/smart-app-launch/1.0.0/#ehr-launch-sequence). If your application uses EHR launch flow, you must provide a launch URL during registration and include the `launch` scope in your requested scopes. The EHR will redirect to this launch URL with `launch` parameters that must be passed back during authorization.
* **JWKS (JSON Web Key Sets) URL**: You can skip this field as it's not required.

> [!NOTE]
>
> Any information not provided will surface to the provider as "Not provided by app developer".

**4. Obtain API credentials**

After submitting your application, API credentials will be delivered to you via your PDS API portal. You'll receive:

* **Client ID** (OAuth Client ID)
* **Client Secret** (OAuth Client Secret)

You'll need these credentials when configuring your integration in Nango.

## API Considerations

When working with the PracticeFusion API, keep these important points in mind:

* **Base URL requirement**: Each PracticeFusion practice has a unique Base URL that must be provided when creating a connection. You can find your practice's Base URL by downloading the [ServiceBaseURLs.json](https://www.practicefusion.com/assets/static_files/ServiceBaseURLs.json) file and searching for your practice. Look for the endpoint with the `name` "Patient Access" to access patient records or "Provider / System Access" for system access records and use its `fullUrl` value (omitting the `https://` prefix).
* **EHR Launch**: For provider applications using EHR launch flow, the EHR redirects to your registered launch URL with `launch` and `iss` query parameters. The `launch` parameter is an opaque identifier for the specific launch context and must be included in your authorization request. You must request the `launch` scope and have it approved during app registration to use EHR launch.

For more details on PracticeFusion's OAuth implementation, see the PracticeFusion documentation on [registering an application](https://www.practicefusion.com/fhir/get-started/) and [Authentication and Authorization](https://www.practicefusion.com/fhir/api-specifications/#authentication-and-authorization).

***


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