Sign in
latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

FacilityCredentialingWorkflow

Queue bulk facility workflow creation with progress tracking (v2)

Accepts a bulk workflow creation request, creates a trackable bulk-request record, and enqueues one creation task per facility for reliable background processing. Returns immediately with 202 Accepted. When to use: Prefer this over POST /bulk-create (v1) for new integrations. v2 records a bulk-request entry that can be used to track per-facility progress. For a single facility, use POST /facility-credentialing-workflows. Preconditions: Each facility must already exist in the system. Side effects: Individual creation tasks are dispatched to a background queue. Each task calls the POST /cloud-create internal callback. Processing is asynchronous — the caller receives 202 Accepted before any workflow is created. Returns: 202 Accepted.

post/facility-credentialing-workflows/v2/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. Individual workflows will be created via Cloud Tasks.

object required