CreatePatientPreferredPharmacies

Last updated: 7 Nov 2025

Creates preferred pharmacies for a patient.

Parameters #

Name	Type	Description
patient_id	str or UUID	The unique identifier of the patient.
pharmacies	list[PatientPreferredPharmacy]	List of pharmacies to create.

PatientPreferredPharmacy #

The PatientPreferredPharmacy dataclass represents a patient’s preferred pharmacy, and if it’s their default pharmacy.

Validation #

When this effect is interpreted, Canvas validates the ncpdp_id before setting the preferred pharmacy. If the ncpdp_id is invalid or does not exist, the effect will fail.

To ensure the ncpdp_id exists before using this effect, you can verify it using Canvas’s pharmacy HTTP utility to check the pharmacy beforehand.

Attributes #

Attribute	Type	Description	Required
ncpdp_id	str	The NCPDC identifier of the pharmacy.	Yes
default	bool	Indicates if this is the patient’s default pharmacy.	No, defaults to False

Example #

from canvas_sdk.effects.patient import CreatePatientPreferredPharmacies, PatientPreferredPharmacy
from canvas_sdk.v1.data import Patient as PatientModel

first_patient_id = PatientModel.objects.values_list("id", flat=True).first()

preferred_pharmacies_effect = CreatePatientPreferredPharmacies(
                                pharmacies=[PatientPreferredPharmacy(ncpdp_id="0586163", default=True)],
                                patient_id=first_patient_id
)

preferred_pharmacies_effect.create()

This effect will create a new preferred pharmacy for the specified patient.

Since the default attribute is set to True, it will mark this pharmacy as the patient’s default preferred pharmacy.