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.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.