Skip to main content

Application Registration

warning

The Netsmart CareConnect FHIR APIs have received a significant update which introduces a new authorization server and new tenant specific base URLs. The process for registering your application for the new APIs has changed as a result.

To get started working with the Netsmart APIs you will first need to:

  • Determine the API(s) you will use.
  • Create an Account.
  • Register your Application.
  • Request Authorization.

Before You Begin​

We have implemented new authorization servers and APIs to better support the latest SMART on FHIR requirements. The process to register and obtain authorization is different depending on the APIs you are intending to use.

Current APIs​

This following APIs use our new developer portal and authorization server.

Previous APIs​

The following APIs use our original authorization server.

Create an Account​

warning

This feature is currently in early testing and is subject to change.

  1. To create a Developer account, navigate to the Developer Portal for the environment you wish to work with:
  2. Select Sign Up.
  3. Enter the following information:
    • Username (must be unique and cannot be your email address)
    • Given Name (i.e., First Name)
    • Family Name (i.e., Last Name)
    • Email Address
    • Password (choose a unique strong password to keep your account secure)
    • Re-enter Password
  4. Select Sign Up.
  5. Verification process to be documented.

Register your Application​

Once you are logged in, you are now able to register your application.

  1. Select Applications in the top navigationbar.
  2. Select Create Application.
  3. This will launch a guided setup to get your application registered. Prompts include:
    1. Type (e.g., Patient-facing application or System integration)
    2. Platform (e.g., Web server application or Mobile/Desktop application)
    3. Access (i.e., Provider APIs or Payer APIs)
    4. Authentication (i.e., Client Secret or Private Key JWT)
    5. Details (e.g., Application name, Company Name, Redirect URIs, etc.)
  4. At the end of the guided setup, review the answers and the resulting OAuth configuration. Go back to make any corrections as needed.
  5. If correct, select Create Application.
  6. You will be shown your application details.

Now that your app is registered, you can retrieve the client id and secret and be able to use this app with one of our solutions once it has been authorized.

Request Authorization​

  1. Select the Tenant Authorization tab.
  2. Under Request Tenant Authorization, search for and select the Organization (tenant) you would like access to.
  3. Select Request Authorization.
  4. Your authorization request has now been submitted and will be reviewed by a owner of that tenant.