Method: fhir.create

Full name: projects.locations.datasets.fhirStores.fhir.create

Creates a FHIR resource.

Implements the FHIR standard create interaction, which creates a new resource with a server-assigned resource ID.

Also supports the FHIR standard conditional create interaction, specified by supplying an If-None-Exist header containing a FHIR search query. If no resources match this search query, the server processes the create operation as normal.

The request body must contain a JSON-encoded FHIR resource, and the request headers must contain Content-Type: application/fhir+json.

On success, the response body will contain a JSON-encoded representation of the resource as it was created on the server, including the server-assigned resource ID and version ID. Errors generated by the FHIR store will contain a JSON-encoded OperationOutcome resource describing the reason for the error. If the request cannot be mapped to a valid API method on a FHIR store, a generic GCP error might be returned instead.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The name of the FHIR store this resource belongs to.

Authorization requires the following Google IAM permission on the specified resource parent:

  • healthcare.fhirResources.create



The FHIR resource type to create, such as Patient or Observation. For a complete list, see the FHIR Resource Index. Must match the resource type in the provided content.

Request body

The request body contains an instance of HttpBody.

Response body

If successful, the response is a generic HTTP response whose format is defined by the method.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Healthcare API