---
schema_version: "1"
id: eb5c28e096da79e34d447c478ab7affade4ac0613300dca8ea5149b04edccfa1
title: Create Referral Action
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/hc_actions_create_referral.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_actions_create_referral.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 545ac056acb4fca49830ba7c69ff25c50b140c7435e8ba3e3ceffb2918273fd1
description: Create a patient referral record. A patient referral consists of multiple objects, such as an account, clinical service request, and clinical service request detail.
---
# Create Referral Action

Create a patient referral record. A patient referral consists of multiple objects, such as an account, clinical service request, and clinical service request detail.

This action is available in API version 59.0 and later for users with the Health Cloud license.

## Supported REST HTTP Methods

**URI**: /services/data/vXX.X/actions/standard/createReferral

Where XX.X is the latest API version.

**Formats**: JSON, XML

**HTTP Methods**: POST

**Authentication**: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

## Inputs

| Input | Type | Description |
| --- | --- | --- |
| matchDuplicates | Boolean | Indicates whether to match a duplicate record that has the highest matching confidence (true) or not (false). |
| performers | String\[\] | Required. Comma-separated list of IDs of the organizations or practitioners who perform the service. |
| referralDetailsRecords | Reference | Collection of ClinicalServiceRequestDetails records that contain the referral information. |
| referralNotes | String | Referral notes. |
| referralRecord | Reference | Required. ClinicalServiceRequest record that contains referral information. |
| requesterId | String | Required. ID of the provider requesting the service. |
| subjectRecord | Reference | Required. Account details of the patient being referred. |

## Outputs

| Output | Type | Description |
| --- | --- | --- |
| referralIds | String\[\] | List of IDs of the new referral records. |

## Example

**Sample Request**

{
   "inputs":\[
      {
         "subjectRecord":{
            "Id":"001RM000005bZVvYAM",
            "FirstName":"Joe",
            "LastName":"Clark"
         },
         "requesterId":"001RM000005bZW0YAM",
         "performers":\[
            "001RM000005bZW5YAM"
         \],
         "referralRecord":{
            "Priority":"Routine",
            "Status":"Draft",
            "Type":"Plan"
         },
         "matchDuplicates":false,
         "referralNotes":"This is an urgent request",
         "referralDetails":\[
            {
               "detailType":"Insurance",
               "detailRecordType":"Member Plan",
               "detailRecordId":"0SqRM00000000N10AI"
            }
         \]
      }
   \]
}

**Sample Response**

{
  "errors": null,
  "isSuccess": true,
  "outputValues": {
    "referralIds": \[
      "0lvxx00004000001AAB"
    \]
  }
}