latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

FacilityCredentialingWorkflow

Create a single facility credentialing workflow

Creates a new facility credentialing workflow for one facility and immediately hydrates it with facility data from upstream systems. When to use: Use this to onboard an individual facility into the credentialing process. For multiple facilities at once, use POST /facility-credentialing-workflows/v2/bulk-create (preferred) or POST /facility-credentialing-workflows/bulk-create. Preconditions: The facility identified by certifyFacilityId in the request body must already exist in the system. Only one active workflow per facility is allowed — if an active workflow exists, a 409 Conflict is returned. Returns: 201 Created with the full, hydrated GetFacilityCredentialingWorkflowResponse in the body, including facility data populated from upstream. On business-rule violations (e.g., invalid facility state), a 422 Unprocessable Entity is returned.

post/facility-credentialing-workflows

Headers

tenant-idstring required

Tenant ID

Request body

certifyFacilityIdstring required

Certify facility ID to hydrate facility data automatically

Example request

{
  "certifyFacilityId": "cf_123456"
}

Response

Successfully created the facility credentialing workflow

idstring

Unique identifier for the facility credentialing workflow

tenantIdstring

ID of the tenant

certifyFacilityIdstring

Certify facility ID

tenantFacilityIdstring

ID of the tenant facility

createdBystring

ID of the user who created the facility credentialing workflow

updatedBystring

ID of the user who updated the facility credentialing workflow

createdAtstring date-time
updatedAtstring date-time

Example response

{
  "id": "1234",
  "tenantId": "tenant_123456",
  "certifyFacilityId": "cf_123456",
  "tenantFacilityId": "tf_123456",
  "data": {
    "credentialingStatus": "IN_PROGRESS",
    "credentialingDecisionDate": "2024-06-15",
    "nextCredentialingDate": "2025-06-15",
    "psvReadyDate": "2024-05-01T14:20:00Z",
    "psvCompletedDate": "2024-06-01T16:45:00Z",
    "credentialingStatusLastUpdatedDate": "2024-01-15T10:30:00Z"
  },
  "createdBy": "user_123456",
  "updatedBy": "user_123456",
  "createdAt": "2022-03-10T16:15:50Z",
  "updatedAt": "2022-03-10T16:15:50Z"
}