NikoHealth integration

Find or Create Referring Provider

Perform Find or Create Referring Provider through NikoHealth.

View as Markdown

nikohealth_find_or_create_referring_provider

writenikohealth

Inputs

npi
expressionrequired
Npi
Required literal value or workflow expression.
first_name
expression
First Name
Optional literal value or workflow expression.
last_name
expression
Last Name
Optional literal value or workflow expression.
address_line
expression
Address Line
Optional literal value or workflow expression.
address_line_2
expression
Address Line 2
Optional literal value or workflow expression.
city
expression
City
Optional literal value or workflow expression.
state
expression
State
Optional literal value or workflow expression.
zip
expression
Zip
Optional literal value or workflow expression.
phone
expression
Phone
Optional literal value or workflow expression.
fax
expression
Fax
Optional literal value or workflow expression.
email
expression
Email
Optional literal value or workflow expression.
title
expression
Title
Optional literal value or workflow expression.
practice
expression
Practice
Optional literal value or workflow expression.
note
expression
Note
Optional literal value or workflow expression.
location_name
expression
Location Name
Optional literal value or workflow expression.
create_if_missing
boolean
Create If Missing
Optional true-or-false value.
Default: "true"
use_npi_registry
boolean
Use Npi Registry
Optional true-or-false value.
Default: "true"

Outputs

successSuccess
provider_idProvider Id
location_idLocation Id
createdCreated
lookup_statusLookup Status
npiNpi
registry_usedRegistry Used
readback_verifiedReadback Verified
missing_fieldsMissing Fields
failure_categoryFailure Category
status_codeStatus Code
correlation_idCorrelation Id
error_typeError Type
errorError

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

{
  "type": "object",
  "required": [
    "npi"
  ],
  "properties": {
    "fax": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "npi": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "zip": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "city": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "note": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "email": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "phone": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "state": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "title": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "practice": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "last_name": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "first_name": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "address_line": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "location_name": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "address_line_2": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "use_npi_registry": {
      "type": "boolean",
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "create_if_missing": {
      "type": "boolean",
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    }
  },
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "npi": {},
    "error": {},
    "created": {},
    "success": {},
    "error_type": {},
    "location_id": {},
    "provider_id": {},
    "status_code": {},
    "lookup_status": {},
    "registry_used": {},
    "correlation_id": {},
    "missing_fields": {},
    "failure_category": {},
    "readback_verified": {}
  },
  "additionalProperties": true
}

View all NikoHealth actions