Provider Assigned

Fires when a provider is assigned to approve a prescription. targetEntity is the PrescriptionFulfillment. The eventType is provider_was_assigned.

Field guarantees

Field	Guarantee
`eventData.practitioner`	✅ Always present (v1)
`practitioner` in v2	⛔ Not delivered — not on the allowlist
v2 order reference (`order_id`, `commerce_status`)	✅ Present when the fulfillment's order is populated

🚧
The assigned provider is v1-only. v2 payloads carry the order reference but not practitioner. Keep this webhook on v1 to know which provider was assigned.

v1 payload (legacy)

ownerEntity is the full patient document (contains PHI); abbreviated here.

{
  "ownerEntityModel": "Patient",
  "targetEntityModel": "PrescriptionFulfillment",
  "deleted": false,
  "ownerEntity": { "id": "pat::43e3b917-xxxx-xxxx-xxxx-70679b4a1b3f", "firstName": "<PATIENT_FIRST_NAME>", "lastName": "<PATIENT_LAST_NAME>", "…": "full patient document" },
  "targetEntity": {
    "status": "started",
    "prescription": "prescr::39538082-xxxx-xxxx-xxxx-ebea6e7a6c09",
    "order": "order::b6b288b5-xxxx-xxxx-xxxx-074dcdbfc4b2",
    "id": "prfm::8579e3c2-xxxx-xxxx-xxxx-424c82e68945"
  },
  "eventTitle": "Provider (Example Provider) was assigned to approve the prescription.",
  "eventType": "provider_was_assigned",
  "eventData": {
    "practitioner": "usr::6c7a2816-xxxx-xxxx-xxxx-043b8b7e79cd"
  },
  "createdAt": "2023-06-09T19:51:46.290Z",
  "updatedAt": "2023-06-09T19:51:46.290Z",
  "__v": 0,
  "id": "event::16e46d3e-xxxx-xxxx-xxxx-3a6e3f7c1a2b"
}

`eventData` field	Type	Always?	Notes
`practitioner`	string	✅	User id of the assigned provider

v2 payload

Sanitized envelope. practitioner is not on the allowlist; order_id/commerce_status resolve from the fulfillment's order.

{
  "event_type": "provider_was_assigned",
  "event_id": "event::16e46d3e-xxxx-xxxx-xxxx-3a6e3f7c1a2b",
  "api_version": "2026-08-09",
  "timestamp": "2026-05-30T14:00:00.000Z",
  "affiliate_id": "aff::c1636be3-xxxx-xxxx-xxxx-9dddc26e77b3",
  "patient_id": "pat::43e3b917-xxxx-xxxx-xxxx-70679b4a1b3f",
  "patient_external_id": "ext-patient-123",
  "patient_marketing_consent": false,
  "is_returning_patient": false,
  "order_id": "order::b6b288b5-xxxx-xxxx-xxxx-074dcdbfc4b2",
  "commerce_status": "started"
}

Field	Delivered in v2	Notes
Envelope + patient identity	✅
`order_id`, `commerce_status`	✅	From the fulfillment's order
`practitioner`	⛔	Not on the allowlist