Care flows can be started (i.e. enrolled) in multiple ways—via the app, API, webhooks, bulk enrollment, and more. Enrollment Triggers is a dedicated section in the app to view and manage what initiates a care flow.
Note: Enrollment Triggers is still in active development. Learn more about the different triggers below and their state.
Trigger types
Manual enrollment
By default, every care flow can be triggered manually—either through Awell Care or the Orchestration API. This trigger type is always enabled, requires no setup, and cannot be disabled.
(Extension) Webhooks
A care flow can be triggered by an event emitted from a third-party system. To set up webhook-based enrollment using an Extension, follow these steps:
Install the Extension
First, install the Extension for the third-party system you want to listen to.Set Up an Incoming Webhook Integration
Once the Extension is installed, create an incoming webhook integration linked to the Extension.Configure the Enrollment Trigger
Link the incoming webhook to the Enrollment Trigger you're creating. Complete the setup by configuring data mapping and defining any trigger conditions.
Data mapping
Incoming webhooks can expose data that you can ingest into your care flow using baseline data points. If your care flow includes required baseline data points, you’ll need to map them to the corresponding fields from the webhook payload during setup.
Trigger conditions
Not every incoming webhook event might need to trigger a care flow. With trigger conditions, you can apply filters based on the webhook payload—ensuring the care flow only starts when specific criteria are met.
To define trigger conditions, you must first send at least one webhook event with a payload to the webhook endpoint. This allows Awell to analyze and destructure the payload, so you can set conditions based on its structure.
Hosted Pages Link
A shareable link that instantly starts a care flow and takes the user directly to Hosted Pages—ideal for onboarding or any flow where immediate user action is required.
Currently, Hosted Pages links are not managed through Enrollment Triggers, and existing links won’t appear in the Enrollment Triggers list. To view or manage your shareable links, go to Hosted Pages Settings.
Bulk Enrollment
Unlike transactional triggers that enroll patients one at a time, bulk enrollment allows you to start care flows for multiple patients at once. Currently, two integration methods are supported:
CSV File Upload
Upload a CSV file to a designated file bucket—each row represents a care flow to be started.Bulk Enrollment API
Use the API to programmatically enroll multiple patients in a single request.
Bulk Enrollment is not yet manageable through the Enrollment Triggers section in the app. Support for this is coming soon. In the meantime, if you’d like to set up Bulk Enrollment, please reach out to our Customer Success team for assistance.