# Prepare Prior Auth Preview

> Perform Prepare Prior Auth Preview through Carelon.

Source: [https://genhealth.ai/docs/workflows/integrations/carelon/carelon_preview_prior_auth](https://genhealth.ai/docs/workflows/integrations/carelon/carelon_preview_prior_auth)

Integration: [Carelon](https://genhealth.ai/docs/workflows/integrations/carelon.md)

- Handler: `carelon_preview_prior_auth`

- Connection type: `carelon`

## Inputs

- `first_name` — First Name (expression, required)
  Required literal value or workflow expression.
- `source_order_id` — Source Order Id (expression, required)
  Required literal value or workflow expression.
- `last_name` — Last Name (expression, required)
  Required literal value or workflow expression.
- `member_number` — Member Number (expression, required)
  Required literal value or workflow expression.
- `date_of_birth` — Date Of Birth (expression, required)
  Required literal value or workflow expression.
- `date_of_service` — Date Of Service (expression, required)
  Required literal value or workflow expression.
- `cpt_code` — Cpt Code (expression, required)
  Required literal value or workflow expression.
- `icd_code` — Icd Code (expression, required)
  Required literal value or workflow expression.
- `solution_card_id` — Solution Card Id (expression, required)
  Required literal value or workflow expression.
- `ordering_npi` — Ordering Npi (expression, required)
  Required literal value or workflow expression.
- `ordering_state` — Ordering State (expression)
  Optional literal value or workflow expression.
- `ordering_match` — Ordering Match (expression)
  Optional literal value or workflow expression.
- `substitute_missing_ordering_provider` — Substitute Missing Ordering Provider (boolean)
  Optional true-or-false value.
  Default: `false`
- `servicing_npi` — Servicing Npi (expression, required)
  Required literal value or workflow expression.
- `servicing_state` — Servicing State (expression)
  Optional literal value or workflow expression.
- `servicing_match` — Servicing Match (expression)
  Optional literal value or workflow expression.
- `phone_type` — Phone Type (expression)
  Optional literal value or workflow expression.
- `phone` — Phone (expression)
  Optional literal value or workflow expression.
- `document_ids` — Document Ids (expression)
  Optional literal value or workflow expression.
- `supplied_answers` — Supplied Answers (repeatable_group)
  Optional list of structured items.
  - `question_text` — Question Text (expression, required)
    Required literal value or workflow expression.
  - `kind` — Kind (select, required)
    Required selected identifier or value.
    Options: Single choice ("single_choice"), Multi-select ("multi_select"), Value entry ("value_entry")
  - `expected_options` — Expected Options (expression)
    Optional literal value or workflow expression.
  - `select` — Select (expression)
    Optional literal value or workflow expression.
  - `value` — Value (expression)
    Optional literal value or workflow expression.

## Outputs

- `success` — Success
- `failure_category` — Failure Category
- `outcome` — Outcome
- `dry_run` — Dry Run
- `is_authorized` — Is Authorized
- `retryable` — Retryable
- `manual_review` — Manual Review
- `unanswered_question_id` — Unanswered Question Id
- `unanswered_question_text` — Unanswered Question Text
- `unanswered_question_kind` — Unanswered Question Kind
- `unanswered_question_options` — Unanswered Question Options
- `unanswered_question_exclusive_options` — Unanswered Question Exclusive Options
- `answered_question_count` — Answered Question Count
- `answer_trail` — Answer Trail
- `configured_answer_count` — Configured Answer Count
- `supplied_answer_count` — Supplied Answer Count
- `derived_answer_count` — Derived Answer Count
- `lowest_derived_confidence` — Lowest Derived Confidence
- `clinical_outcomes` — Clinical Outcomes
- `provider_substitution` — Provider Substitution
- `substituted_ordering_npi` — Substituted Ordering Npi
- `route` — Route
- `error` — Error

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": [
    "first_name",
    "source_order_id",
    "last_name",
    "member_number",
    "date_of_birth",
    "date_of_service",
    "cpt_code",
    "icd_code",
    "solution_card_id",
    "ordering_npi",
    "servicing_npi"
  ],
  "properties": {
    "phone": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "cpt_code": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "icd_code": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "last_name": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "first_name": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "phone_type": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "document_ids": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "ordering_npi": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "date_of_birth": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "member_number": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "servicing_npi": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "ordering_match": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "ordering_state": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "date_of_service": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "servicing_match": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "servicing_state": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "source_order_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "solution_card_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "supplied_answers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "question_text",
          "kind"
        ],
        "properties": {
          "kind": {
            "enum": [
              "single_choice",
              "multi_select",
              "value_entry"
            ],
            "type": "string",
            "description": "Required selected identifier or value.",
            "x-workflow-field-type": "select"
          },
          "value": {
            "description": "Optional literal value or workflow expression.",
            "x-workflow-field-type": "expression"
          },
          "select": {
            "description": "Optional literal value or workflow expression.",
            "x-workflow-field-type": "expression"
          },
          "question_text": {
            "description": "Required literal value or workflow expression.",
            "x-workflow-field-type": "expression"
          },
          "expected_options": {
            "description": "Optional literal value or workflow expression.",
            "x-workflow-field-type": "expression"
          }
        },
        "additionalProperties": false
      },
      "description": "Optional list of structured items.",
      "x-workflow-field-type": "repeatable_group"
    },
    "substitute_missing_ordering_provider": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "error": {},
    "route": {},
    "dry_run": {},
    "outcome": {},
    "success": {},
    "retryable": {},
    "answer_trail": {},
    "is_authorized": {},
    "manual_review": {},
    "failure_category": {},
    "clinical_outcomes": {},
    "derived_answer_count": {},
    "provider_substitution": {},
    "supplied_answer_count": {},
    "unanswered_question_id": {},
    "answered_question_count": {},
    "configured_answer_count": {},
    "substituted_ordering_npi": {},
    "unanswered_question_kind": {},
    "unanswered_question_text": {},
    "lowest_derived_confidence": {},
    "unanswered_question_options": {},
    "unanswered_question_exclusive_options": {}
  },
  "additionalProperties": true
}
```