Creating an Authorization

This guide walks you through the step-by-step process of programmatically creating an authorization in the VBAPI platform, including the associated diagnosis and procedure codes. These steps are essential for automating prior authorization workflows in your application or integration.

Step 1: Create the Authorization Record

Start by creating the core authorization record. This contains high-level details like the member, provider, authorization type, service dates, and status.

Endpoint

Create Authorization

Step 2: Attach Diagnosis and Procedure Codes

Once the core authorization is created, link relevant diagnosis and procedure codes to define what the authorization is actually for.

🔹 Add a Procedure Code

Use this endpoint to attach each CPT or procedure code:

Create Authorization Procedure Code

🔹 Add a Diagnosis Code

Use this endpoint to assign ICD-10 diagnosis codes associated with the authorization request:

Create Authorization Diagnostic Code

Summary

To fully load an authorization:

  1. Create the base authorization record.
  2. Add one or more procedure codes.
  3. Add one or more diagnosis codes.

This sequence ensures your authorization is complete and ready for review or adjudication. For additional configuration options such as review levels, units, or linking to clinical documentation, explore the full Authorization API section.