Create

A client may create a new resource on an HDR FHIR server by performing a Create operation. The Create uses an HTTP POST against the URL [baseUrl]/[resourceName]. This POST should have a Content-Type header which specifies the MIME type of the payload.

The following example shows a simple Patient resource create using a JSON Payload.

Request: FHIR CRUD Create operation

Response: FHIR CRUD Create operation

The endpoint responds with a response similar to the following:

Conditional Create: Conditional Create can be used when you want to create a resource only if a matching resource does not already exist, based on a specified FHIR search URL expression. In this case, an HTTP POST request is still used, but an additional header, If-None-Exist, is included in the request.

Example:

URL: [baseUrl]/Patient

HTTP Headers

If-None-Exist: identifier=http://example.org|12345

Content-Type: application/fhir+json

In this case, the server will evaluate the search criteria specified in the If-None-Exist header. If no existing Patient resource matches the search criteria, a new Patient resource will be created. However, if a matching Patient resource is found, no new resource will be created or modified.