Skip to content
Avara
Get started
API Reference
Auto Scribe
Clinical References

Create a clinical reference

ClinicalReference AutoScribe.ClinicalReferences.Create(ClinicalReferenceCreateParamsparameters, CancellationTokencancellationToken = default)
POST/v1/autoScribe/clinicalReferences

Creates a canonical clinical reference value for study workflow pickers and normalization.

ParametersExpand Collapse
ClinicalReferenceCreateParams parameters
required string name
minLength1
required ClinicalReferenceType type

Category of canonical clinical reference value used for study workflow pickers and normalization.

string expressCustomerID
string? externalReferenceID
minLength1
IReadOnlyDictionary<string, string> metadata
ReturnsExpand Collapse
class ClinicalReference:

A canonical clinical reference value for study workflow pickers and normalization

required string ClinicalReferenceID

Unique clinical reference identifier. Format: ref_{32-hex-chars}

required DateTimeOffset? CreatedAt

Timestamp when the clinical reference was created

formatdate-time
required Boolean IsActive

Whether this reference is active and available for pickers

required string Name

Canonical display name for this reference value

minLength1
required ClinicalReferenceType Type

Category of canonical clinical reference value used for study workflow pickers and normalization.

One of the following:
"facility"Facility
"referring_provider"ReferringProvider
"study_description"StudyDescription
"procedure"Procedure
required DateTimeOffset? UpdatedAt

Timestamp when the clinical reference was last updated

formatdate-time
ExpressCustomerReference? ExpressCustomer

A reference to an Express customer with basic identifying information

required string ExpressCustomerID

Unique Express customer identifier. Format: cus_{32-hex-chars}

required string ExpressCustomerName

Name of the Express customer

minLength1
string? ExternalReferenceID

Integrator-provided stable identifier for mapping inbound data

IReadOnlyDictionary<string, string> Metadata

Optional key-value metadata. Maximum 50 pairs

Create a clinical reference

ClinicalReferenceCreateParams parameters = new()
{
    Name = "City Medical Center",
    Type = ClinicalReferenceType.Facility,
};

var clinicalReference = await client.AutoScribe.ClinicalReferences.Create(parameters);

Console.WriteLine(clinicalReference);
{
  "clinicalReferenceId": "ref_1234567890abcdef1234567890abcdef",
  "createdAt": "2024-01-15T09:00:00Z",
  "isActive": true,
  "name": "City Medical Center",
  "type": "facility",
  "updatedAt": "2024-03-15T14:20:00Z",
  "expressCustomer": {
    "expressCustomerId": "cus_1234567890abcdef1234567890abcdef",
    "expressCustomerName": "City Medical Center"
  },
  "externalReferenceId": "FAC-001",
  "metadata": {
    "region": "northeast"
  }
}
Returns Examples
{
  "clinicalReferenceId": "ref_1234567890abcdef1234567890abcdef",
  "createdAt": "2024-01-15T09:00:00Z",
  "isActive": true,
  "name": "City Medical Center",
  "type": "facility",
  "updatedAt": "2024-03-15T14:20:00Z",
  "expressCustomer": {
    "expressCustomerId": "cus_1234567890abcdef1234567890abcdef",
    "expressCustomerName": "City Medical Center"
  },
  "externalReferenceId": "FAC-001",
  "metadata": {
    "region": "northeast"
  }
}