Skip to content

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.

POST
/v1/sandbox/requests

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.

Authorization

AuthorizationBearer <token>

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

Api-Version?enum

Overrides the app's pinned dated version for this request.

Idempotency-Key?string

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}

Was this page helpful?