How the RPM Flow Works

Let's walk through the steps to enroll a patient and get them started with Athelas RPM. We'll start with just our staging/production credentials, and end up with your first patient created & ready to ship a device to in just three simple steps.

Clients will be provided the following parameters (needed to create a site, etc.) when they are first set up with the Athelas API. You will need the former two to negotiate bearer tokens for authentication with all other endpoints, and the latter two to create some of the constructs we list below.

Staging credentials
Production credentials
User ID
Organization ID

Step 1: Create a Site

To begin adding patients, we first need to create a site.
A site represents a collection of patients in some form. Here are some examples of sites:

A clinic
A hospital
A nursing home

Sites are useful for organizing patients together into a group.

To create a site, use the /sites/create endpoint.

Step 2: Create a Prescriber

Each patient must also be associated to a prescriber, or doctor. A prescriber has access to all their patients' results and is able to communicate with them as needed.

Each prescriber belongs to a site (created in step 1).

To create a prescriber, use the /prescribers/create endpoint.

Step 3: Create Patients

Now, you can create the patients who will enroll into your program. Each patient is associated to the following:

A site
A prescriber

Creating a patient necessitates the presence of an address in the 'address' parameter. Ensure that you are marking the first test parameter true for the test of your choice as well. Once the patient has been created with these two parameters, set the patient's active attribute to True.

Our deployment team will see that this patient is due for a test device (that you specified earlier) and will ship this device to them. You can track these packages using our Athelas package tracking solutions, where we send you the tracking number of the product (e.g. webhook that you provide us).

To make sure that they are shipped to, make sure to enable the ship_rpm_devices flag when you create the patient. This will ensure that the devices are scheduled to ship!