latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

FacilityCredentialingWorkflow

Asynchronously create workflows for multiple facilities (v1)

Accepts a list of facility identifiers and begins creating a credentialing workflow for each in the background. Processing starts immediately; the endpoint returns 202 Accepted without waiting for completion. When to use: Prefer POST /facility-credentialing-workflows/v2/bulk-create for new integrations — v2 provides reliable processing via a queue and a trackable bulk-request record. Use v1 only for legacy compatibility. Preconditions: Each facility must already exist in the system. Facilities that do not exist will fail silently during background processing. Side effects: Each workflow is created independently with automatic facility data hydration. Failures are logged server-side but are not surfaced to the caller — there is no completion notification, callback, or polling mechanism. Returns: 202 Accepted immediately. Individual results are not returned.

post/facility-credentialing-workflows/bulk-create

Headers

tenant-idstring required

Tenant ID

Request body

certifyFacilityIdsstring[]

List of certify facility IDs to create workflows for. Required when isSelectAll is false. Ignored when isSelectAll is true (facility IDs will be fetched using the filter).

filterstring

Filter criteria as JSON string (URL encoded). Used to find facilities when isSelectAll is true. Facility IDs from matching facilities will be used to create new workflows. See GET /facilities endpoint documentation for filter format. Filterable fields include: data.npi, data.name.

isSelectAllboolean

If true, find all facilities matching the filter criteria and create workflows for those facilities, instead of using certifyFacilityIds. When true, filter parameter is required and certifyFacilityIds will be ignored.

Example request

{
  "certifyFacilityIds": [
    "cf_123456",
    "cf_789012"
  ],
  "filter": "{\"data.npi\":{\"eq\":\"1234567890\"}}"
}

Response

Bulk workflow creation request accepted and processing started. The operation will complete in the background.

object required