Create a patient request
Creates a patient request on a synthetic encounter as if the patient tapped it (skipping the undo window), to test `request.created` webhooks and write-back.
Creates a patient request on a synthetic encounter as if the patient tapped it (skipping the undo window), to test request.created webhooks and write-back.
OAuth 2.0 client credentials. private_key_jwt (SMART Backend Services asymmetric) is recommended; client secrets need an IP allowlist or mTLS outside the sandbox.
In: header
Scope: sandbox:write
Header Parameters
Overrides the app's pinned dated version for this request.
1–255 characters of [A-Za-z0-9._:-] (a UUID v4 is recommended); never PHI. Stored 24 hours per app.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/sandbox/requests" \ -H "Content-Type: application/json" \ -d '{ "type": "blanket" }'{ "acknowledgedAt": "2026-09-14T15:00:11.402Z", "acknowledgedBy": { "appId": "app_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e", "kind": "staff", "practitioner": { "display": "string", "identifiers": [ { "externalId": "string", "idSystem": "string" } ] } }, "category": "location", "createdAt": "2026-09-14T15:00:11.402Z", "encounterId": "enc_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e", "escalationLevel": 0, "id": "req_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e", "label": { "en": "string", "fr": "string" }, "object": "request", "outcome": "done", "priority": "low", "resolvedAt": "2026-09-14T15:00:11.402Z", "routedTo": { "kind": "string" }, "site": "kb-main-ed", "status": "open", "type": "string", "updatedAt": "2026-09-14T15:00:11.402Z", "version": -9007199254740991}