RxSent Developers

Getting access

How a clinic on RxSent and its developers go from sign-up to live orders through the API. Questions at any step: support@rxsent.com.

  1. The clinic signs up. Apply at app.rxsent.com/app/signup. RxSent reviews the application; the clinic orders nothing until it is approved. Its people (clinic administrators, prescribers, clinic staff and billing users) are set up in the console at app.rxsent.com.
  2. Ask for sandbox keys. Email support@rxsent.com with the clinic's name and the developer who will build the connection. You receive a sandbox API key (it begins tr_sandbox_) and its signing secret. The sandbox is https://sandbox-api.rxsent.com and takes synthetic data only: never a real patient.
  3. Build against the sandbox. Follow the Quickstart: the health check, a catalog read, a signed quote and order, safe retries with an idempotency key, and the webhooks your system receives, each verified by its signature.
  4. Certification. When the sandbox run is complete, tell support@rxsent.com. RxSent reviews the run and records which scopes you are certified for. A live key holds only certified scopes.
  5. Go live. After approval, a signed agreement and, where patient data flows, a business associate agreement, you receive a live key (it begins tr_live_) and its signing secret for https://api.rxsent.com. A sandbox key is refused on production and a live key on the sandbox (environment_mismatch).

Optional: one-click sign-in from your EHR

Your EHR can open the clinic's console with one of its users already signed in, with no password typed. Your server asks for a one-time sign-in link for that user, and your EHR opens it in a new browser tab.

You need a key holding the console:launch scope; one-click sign-in switched on for the clinic (ask support@rxsent.com: it is off until then); and the user already set up in the console with the email they sign in with. Only clinic administrators, prescribers, clinic staff and billing users can be signed in this way. A launch never creates a user, signs or sends a prescription, pays for anything, or skips a second factor: a user with two-step sign-in is still asked for their code.

POST https://api.rxsent.com/v1/integrations/console-launch
Authorization: Bearer <your API key>
Content-Type: application/json
X-Signature: <the signature over the exact body bytes, as for every signed call>

{
  "userEmail": "dr.lee@yourclinic.example",
  "nonce": "8f1c2b0e-5d7a-4c33-9b1e-2f6a7d9e0c41",
  "issuedAt": "2026-11-17T15:04:05Z"
}
FieldRule
userEmailThe email the user signs in to the console with: an active user of your clinic.
nonce16 to 128 characters of A-Z a-z 0-9 . _ ~ -, new for every launch: each works once. A UUID is fine.
issuedAtThe current time, ISO 8601 with its offset. Refused if more than 60 seconds old or more than 5 seconds ahead.

Send it from your server, never the browser: the key and signing secret must never reach a user's machine. A success is 201 with launchId and launchUrl. Open launchUrl straight away, for the user who asked: it works once and expires soon. Never store, log or email it.

HTTPerrorMeaning
400invalid_launch_requestthe launch request is not valid
400launch_assertion_expiredthe launch request is too old or dated in the future: issue it immediately before sending, at most 60 seconds earlier
403launch_not_enabledone-click sign-in is not switched on for this clinic
404launch_user_not_foundno active user of this clinic who may sign in this way has that email address
409launch_nonce_reusedthis nonce has already been used: send a new one with every launch
503launch_unavailablea sign-in link could not be issued right now; try again shortly

Credential, signature and scope refusals are the same as on every other call (Errors).

Optional: the console inside your EHR

By default the console opens in its own tab and refuses to be shown inside another site's frame. On request to support@rxsent.com, RxSent can allow one clinic's console to open inside your EHR's window, for the exact https addresses of your EHR (no wildcards). A user who signs in inside the frame is signed in there only.

RxSent can show your clinic's own logo in the console's menu. Emails keep RxSent's logo.