Skip to main content
Network is the API underneath everything in Photon. It has three upserts, patient, prescription and order, two ways to call them, and webhooks to hear what happens next:

GraphQL

For your backend: sync patients and draft prescriptions and orders with a machine token.

MCP

For agents: take intake, search drugs and draft prescriptions as tools. In private preview.

Webhooks

For your backend: get notified as orders are sent, filled, shipped and picked up.

Three upserts

Network has no queries. Each record has one mutation, and how you call it decides what it does:

Photon decides, then tells you

Send what you know, and Photon does the matching, resolution and screening, so your code doesn’t have to. Each response reports what Photon did:
  • The record, as saved.
  • appliedChanges: what was written.
  • unappliedChanges: what wasn’t, and why. When Photon isn’t sure, this lists the options to pick from.
See Changes and choices.

Where Network stops

A machine token can do everything except sign. Signing and sending need a signed-in prescriber, which is what Prescribe is for. Typically, your backend syncs patients and drafts prescriptions and orders. A prescriber then opens the draft in Prescribe, signs it and sends it. See Authentication.