FHIR CRUD
Category: Healthcare Standards
Node id: fhir-crud
Standards: HIPAA, GDPR, SOC2
Performs Search, Read, Create, Update, Delete, and Transaction operations on FHIR R4 resources
What it does
- FHIR R4 Search, Read, Create, Update, and Delete operations
- Resource input as JSON object or JSON string
- Auto-detection of resourceType from resource data
- Bearer token authentication
- Custom HTTP header injection
Use cases
- Create new patient records in a FHIR server
- Update clinical observations after data enrichment
- Delete test or duplicate resources during data cleanup
- Upsert FHIR resources in an ETL pipeline
Runtime
- Performance tier:
variable - Effect:
write
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
resource | json | No | FHIR resource object |
resource_json | text | No | FHIR resource as JSON string |
resource_id | text | No | Resource ID (for update/delete) |
bundle | fhir-bundle | No | Transaction/batch Bundle to POST (for operation=transaction); a map or JSON string |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | CRUD result (resource, resource_json, resource_type, resource_id, operation, deleted) |
success | boolean | No | Whether the operation succeeded |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| FHIR Server URL | fhir_url | string | Yes | Base URL of the FHIR server | ||
| Operation | operation | enum | No | search | search, read, create, update, delete, transaction | FHIR operation to perform |
| Search Parameters | search_params | json | No | Key-value pairs for FHIR search (e.g. {"name": "Smith", "birthdate": "1990-01-01"}) | ||
| Resource Type | resource_type | string | No | FHIR resource type | ||
| Resource ID | resource_id | string | No | Resource ID for update/delete |
Auth
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Auth Token | auth_token | secret | No | Bearer token for FHIR server authentication |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Custom Headers | headers | json | No | Additional HTTP headers |
Errors
| Code | Description |
|---|---|
FHIR_URL_REQUIRED | fhir_url configuration is missing |
FHIR_CREATE_FAILED | FHIR server rejected the create operation |
FHIR_UPDATE_FAILED | FHIR server rejected the update operation |
FHIR_DELETE_FAILED | FHIR server rejected the delete operation |
RESOURCE_REQUIRED | Resource input is missing for create/update |
Runtime notes
- Output shape varies by operation: search returns resources[] array + bundle; read/create/update return a single resource; delete returns {deleted:true} with no resource.
- For search, result contains resources (array of extracted entries), bundle (raw), total, count, resource_type, and operation.
- Either resource (object) or resource_json (string) input is accepted — you do not need both. resource takes priority.
- resource_id can come from the input port OR config; input port overrides config when both are set.
- For operation=transaction, provide a transaction/batch Bundle via the 'bundle' input; the server resolves intra-bundle references and returns a response Bundle in result.bundle.
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..