# Create Referral Intake Case

> Perform Create Referral Intake Case through GenHealth.

Source: [https://genhealth.ai/docs/workflows/integrations/gen-health/genhealth_create_referral_intake_case](https://genhealth.ai/docs/workflows/integrations/gen-health/genhealth_create_referral_intake_case)

Integration: [GenHealth](https://genhealth.ai/docs/workflows/integrations/gen-health.md)

- Handler: `genhealth_create_referral_intake_case`

## Inputs

- `create_idempotency_key` — Create Idempotency Key (text, required)
  Required text value.
- `origin` — Origin (select, required)
  Required selected identifier or value.
  Options: External Fax ("external_fax"), External Email ("external_email"), Internal Provider Referral ("internal_provider_referral"), Manual Upload ("manual_upload")
- `external_case_reference` — External Case Reference (text, required)
  Required text value.
- `service_line` — Service Line (select)
  Optional selected identifier or value.
  Default: `"dme"`
  Options: DME ("dme")
- `source_document_id` — Source Document Id (text)
  Optional text value.
- `source_referral_id` — Source Referral Id (text)
  Optional text value.
- `branch_id` — Branch Id (text)
  Optional text value.
- `patient_snapshot` — Patient Snapshot (json)
  Optional JSON value.
- `referring_provider_snapshot` — Referring Provider Snapshot (json)
  Optional JSON value.
- `referring_party_display_name` — Referring Party Display Name (text)
  Optional text value.
- `referring_party_fax_number` — Referring Party Fax Number (text)
  Optional text value.
- `referring_party_npi` — Referring Party Npi (text)
  Optional text value.
- `referring_party_sending_org_id` — Referring Party Sending Org Id (text)
  Optional text value.
- `suggest_score` — Suggest Score (number)
  Optional numeric value.
- `auto_link_score` — Auto Link Score (number)
  Optional numeric value.

## Outputs

- `success` — Success
- `error` — Error
- `case_id` — Case Id
- `intake_stage` — Intake Stage
- `patient_id` — Patient Id
- `patient_linked` — Patient Linked
- `referring_party_id` — Referring Party Id
- `external_case_reference` — External Case Reference
- `state_version` — State Version

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `write`
- Confirmation recommended: no
- Retry safe: no
- Dry run supported: no

## Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

### Input schema

```json
{
  "type": "object",
  "required": [
    "create_idempotency_key",
    "origin",
    "external_case_reference"
  ],
  "properties": {
    "origin": {
      "enum": [
        "external_fax",
        "external_email",
        "internal_provider_referral",
        "manual_upload"
      ],
      "type": "string",
      "description": "Required selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "branch_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "service_line": {
      "enum": [
        "dme"
      ],
      "type": "string",
      "default": "dme",
      "description": "Optional selected identifier or value.",
      "x-workflow-field-type": "select"
    },
    "suggest_score": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "auto_link_score": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "patient_snapshot": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "source_document_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "source_referral_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "referring_party_npi": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "create_idempotency_key": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "external_case_reference": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "referring_party_fax_number": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "referring_provider_snapshot": {
      "description": "Optional JSON value.",
      "x-workflow-field-type": "json"
    },
    "referring_party_display_name": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "referring_party_sending_org_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "case_id": {},
    "success": {},
    "patient_id": {},
    "intake_stage": {},
    "state_version": {},
    "patient_linked": {},
    "referring_party_id": {},
    "external_case_reference": {}
  },
  "additionalProperties": true
}
```