---
title: "Create a new record in any credentialing workflow section"
method: POST
path: "/credentialing-workflows/{workflowId}/{sectionName}"
tags: ["CredentialingWorkflow"]
---

# Create a new record in any credentialing workflow section

`POST /credentialing-workflows/{workflowId}/{sectionName}`

Generic endpoint to create records in sections: appVerifications, boardCertifications, cds, dea, educationTraining, hospitalAffiliations, licenses, licensureActions, malpracticeInsurance, npdbReports, performanceIndicators, practiceLocations, professionalIds, sanctions, siteVisits, specialties, supportingDocuments

## Path parameters

- `sectionName` string, required
- `workflowId` string, required

## Headers

- `tenant-id` string, required

## Request body

- union
  - AppVerificationUpdateRequest — App verification data for PUT operations that replace the entire app verifications array
    - `verificationType` string, required — The type of verification
    - `explanation` string, required — Explanation of the verification
    - `source` string, required — The source of the verification
    - `createdAt` string, date
    - `createdBy` string — The user who created the record
    - `updatedAt` string, date
    - `updatedBy` string — The user who last updated the record
    - `verifiedDate` string, date
    - `verifiedBy` string — The user who verified the verification
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this app verification
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
    - `disclosureQuestions` DisclosureQuestionItem[] — Array of disclosure questions (only populated for Disclosure Questions verification type)
      - `question` string — The disclosure question text
      - `answer` string — The answer for the question
      - `answerFlag` string — Flag indicating if the answer is unfavorable (true) or favorable (false)
      - `explanation` string — Additional explanation for the question
    - `favorableAnswerCounts` integer — Count of favorable disclosure answers (only for Disclosure Questions verification type)
    - `unfavorableAnswerCounts` integer — Count of unfavorable disclosure answers (only for Disclosure Questions verification type)
    - `deceasedCheckDetails` DeceasedCheckDetails — DMF check details for Deceased Check app verification pop-up
      - `isDeceased` boolean, required — Whether the person was found in DMF as deceased
      - `firstName` string — First name from DMF
      - `middleName` string — Middle name from DMF
      - `lastName` string — Last name from DMF
      - `nameSuffix` string — Name suffix from DMF
      - `dateOfBirth` string — Date of birth from DMF (YYYY-MM-DD)
      - `dateOfDeath` string — Date of death from DMF (YYYY-MM-DD)
      - `verifiedOrProofCode` string — Verified or proof code from DMF
      - `createdAt` string, date
      - `updatedAt` string, date
  - BoardCertificationUpdateRequest — Board certification data for PUT operations that replace the entire certifications array
    - `certificateId` string — Unique identifier for the board certification
    - `certificateType` string — Type of board certification
    - `durationType` string — Duration type of the certification
    - `expirationDate` string, date
    - `issueDate` string, date
    - `speciality` string, required — Medical specialty
    - `subspeciality` string — Medical subspecialty
    - `verifiedBy` string — Person who verified the board certification
    - `verifiedDate` string, date
    - `moc` string — Maintenance of Certification status
    - `status` string, required — Status of the board certification
    - `occuranceType` string — Occurrence type of the certification
    - `recordType` string — Type of record
    - `source` string, required — Source of the board certification information
    - `flaggedDate` string, date
    - `reportDate` string, date
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this board certification
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - CdsUpdateRequest — CDS data for PUT operations that replace the entire CDS array
    - `expirationDate` string, date
    - `state` string, required — The state that issued the CDS license
    - `number` string, required — The CDS License Number
    - `verifiedBy` string — Person who verified the CDS
    - `verifiedDate` string, date
    - `source` string, required — Source of the CDS information
    - `status` string, required — Status of the CDS
    - `url` string — The URL to the CDS information
    - `flaggedDate` string, date
    - `reportDate` string, date
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this CDS record
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - DeaUpdateRequest — DEA data for PUT operations that replace the entire DEA array
    - `expirationDate` string, date
    - `affiliation` string — Affiliation for the DEA
    - `number` string, required — DEA number
    - `state` string, required — State where DEA is registered
    - `providerType` string, required — Type of provider
    - `verifiedBy` string — Person who verified the DEA
    - `verifiedDate` string, date
    - `source` string, required — Source of the DEA information
    - `status` string, required — Status of the DEA
    - `url` string — URL reference for the DEA
    - `flaggedDate` string, date
    - `reportDate` string, date
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this DEA record
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - EducationTrainingUpdateRequest — Education and training data for PUT operations that replace the entire education training array
    - `startDate` string, date
    - `endDate` string, date
    - `type` string — Type of education/training
    - `degree` string — Degree obtained
    - `speciality` string — Specialty area
    - `institution` string — Educational institution name
    - `licensingBoardReference` string — Licensing board reference number
    - `verifiedBy` string — Person who verified the education
    - `verifiedDate` string, date
    - `subspecialty` string — Subspecialty area
    - `status` string — Status of the education/training
    - `source` string, required — Source of the education information
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this education/training record
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - HospitalAffiliationUpdateRequest — Hospital affiliation data for PUT operations that replace the entire hospital affiliations array
    - `name` string, required — Name of the hospital
    - `specialty` string — Specialty at the hospital
    - `state` string — State where hospital is located
    - `type` string, required — Type of affiliation
    - `source` string — Source of the affiliation information
    - `startDate` string, date
    - `endDate` string, date
    - `status` string — Status of the hospital affiliation
    - `verifiedBy` string — Person who verified the affiliation
    - `verifiedDate` string, date
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this hospital affiliation
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - LicenseUpdateRequest — License data for PUT operations that replace the entire licenses array
    - `expiration` string, date, required
    - `issueDate` string, date, required
    - `licenseNumber` string, required — License number
    - `state` string, required — State where license was issued
    - `licenseType` string, required — Type of license
    - `licenseStatus` string, required — Status of the license
    - `licenseSource` string, required — License source of the license information
    - `reportDate` string, date, required
    - `licenseNumberVariations` string — Variations of the license number
    - `practitionerType` string — Type of practitioner
    - `specialty` string — Medical specialty
    - `flaggedDate` string, date
    - `dataSource` string — Data source for the license
    - `url` string — URL for license verification
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this license
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
    - `verifiedBy` string — Person who verified the license
    - `verifiedDate` string, date
  - LicensureActionUpdateRequest — Licensure action data for PUT operations that replace the entire licensure actions array
    - `details` string — Details of the licensure action
    - `state` string, required — State where action was taken
    - `lastActionDate` string, date
    - `reportDate` string, date
    - `source` string, required — Source of the action information
    - `actionType` string — Type of action taken
    - `verifiedBy` string — Person who verified the action
    - `verifiedDate` string, date
    - `createdDate` string, date
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this licensure action
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - MalpracticeInsuranceUpdateRequest — Malpractice insurance data for PUT operations that replace the entire malpractice insurance array
    - `carrierName` string — Malpractice Insurance Carrier Name
    - `effectiveDate` string, date
    - `expiryDate` string, date
    - `type` string — The type of malpractice insurance
    - `unlimitedCoverage` boolean — Whether the policy has unlimited coverage
    - `source` string, required — Source of the malpractice insurance information
    - `status` string, required — Status of the insurance policy
    - `policyNumber` string, required — Policy number
    - `aggregateCoverageAmount` string — Aggregate coverage amount
    - `occuranceCoverageAmount` string — Occurrence coverage amount
    - `verifiedBy` string — Person who verified the insurance
    - `verifiedDate` string, date
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this malpractice insurance record
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - NpdbReportUpdateRequest — NPDB report data for PUT operations that replace the entire NPDB reports array
    - `reportDate` string, date, required
    - `processDate` string, date, required
    - `verifiedBy` string — Person who verified the report
    - `data` object — Additional data associated with the report
    - `verifiedDate` string, date
    - `typeOfAction` string, required — Type of action in the report
    - `createdDate` string, date
    - `deceased` string — Deceased status
    - `paymentAmount` string — Payment amount
    - `paymentDate` string, date
    - `patientAge` string — Age of the patient
    - `patientGender` string — Gender of the patient
    - `patientType` string — Type of patient
    - `medicalConditionDescription` string — Description of medical condition
    - `procedureDescription` string — Description of procedure
    - `allegationsDescription` string — Description of allegations
    - `allegationNature` string — Nature of allegation
    - `specificAllegation` string — Specific allegation details
    - `specificAllegationDate` string, date
    - `outcome` string — Outcome of the report
    - `source` string, required — Source of the report
    - `reportType` string, required — Type of report
    - `firstName` string — First name
    - `lastName` string — Last name
    - `middleName` string — Middle name
    - `gender` string — Gender
    - `npi` string — National Provider Identifier
    - `homeAddress` string — Home address
    - `homeCity` string — Home city
    - `homeState` string — Home state
    - `homeZip` string — Home zip code
    - `dcn` string — Document Control Number
    - `databankSubjectId` string — Databank subject ID
    - `enrollmentStatus` NpdbEnrollmentStatus — Enrollment status information for NPDB reports
      - `dataBank` string — The databank associated with the enrollment status
      - `status` string — The enrollment status
      - `statusCode` string — The code for the enrollment status
      - `section1128e` boolean — Enrollment status related to Section 1128E of the Social Security Act
      - `section1921` boolean — Enrollment status related to Section 1921 of the Social Security Act
      - `titleIV` boolean — Enrollment status related to Title IV of the Social Security Act
      - `startDate` string, date
      - `endDate` string, date
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this NPDB report
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - PerformanceIndicatorUpdateRequest — Performance indicator data for PUT operations that replace the entire performance indicators array
    - `totalComplaints` integer, required — Total number of complaints
    - `clinicalComplaints` integer — Number of clinical complaints
    - `serviceComplaints` integer — Number of service complaints
    - `benefitsComplaints` integer — Number of benefits complaints
    - `claimComplaints` integer — Number of claim complaints
    - `accessIssueComplaints` integer — Number of access issue complaints
    - `reportDate` string, date
    - `verifiedBy` string — Person who verified the performance indicator
    - `verifiedDate` string, date
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this performance indicator record
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - PracticeLocationUpdateRequest — Practice location data for PUT operations that replace the entire practice locations array
    - `address1` string, required — Address line 1
    - `address2` string — Address line 2
    - `city` string, required — City
    - `county` string — County
    - `state` string, required — State
    - `zipcode` string, required — Zip code
    - `healthcareServiceName` string, required — Name of the healthcare service
    - `tin` string — Tax Identification Number
    - `npi` string — National Provider Identifier
    - `country` string, required — Country
    - `startDate` string, date
    - `phoneCoverage24x7` boolean — Whether phone coverage is available 24x7
    - `locationHours` LocationHours[] — Hours of operation for each day of the week
      - `dayOfWeek` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday' — Day of the week
      - `startHours` string — Start time in 12-hour format with AM/PM (e.g., "8:00 AM") or "None" if closed
      - `endHours` string — End time in 12-hour format with AM/PM (e.g., "5:00 PM") or "None" if closed
    - `totalLocationHours` number, double — Total hours per week
    - `drawingBlood` boolean — Whether blood drawing services are available
    - `laboratoryServices` boolean — Whether laboratory services are available
    - `cliaNumber` string — Clinical Laboratory Improvement Amendments number
    - `cliaExpirationDate` string, date
    - `source` string, required — Source of the practice location information
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this practice location
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
    - `verifiedBy` string — Person who verified the practice location
    - `verifiedDate` string, date
  - ProfessionalIdUpdateRequest — Professional ID data for PUT operations that replace the entire professional IDs array
    - `type` string, required — The type of professional ID
    - `number` string, required — The professional ID number
    - `state` string — The state that issued the professional ID
    - `issueDate` string, date
    - `expirationDate` string, date
    - `source` string, required — The source of the professional ID information
    - `createdAt` string, date
    - `createdBy` string — The user who created the record
    - `updatedAt` string, date
    - `updatedBy` string — The user who last updated the record
    - `verifiedDate` string, date
    - `verifiedBy` string — The user who verified the professional ID
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this professional ID
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - SanctionUpdateRequest — Sanction data for PUT operations that replace the entire sanctions array
    - `sourceUpdateDate` string, date, required
    - `sanctionType` string, required — Type of sanction
    - `typeOfAction` string, required — Type of action taken
    - `verifiedBy` string — Person who verified the sanction
    - `verifiedDate` string, date
    - `data` string — Additional data or details about the sanction
    - `source` string, required — Source of the sanction information
    - `flaggedDate` string, date, required
    - `createdAt` string, date
    - `createdBy` string — User who created the record
    - `updatedAt` string, date
    - `updatedBy` string — User who last updated the record
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this sanction record
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - SiteVisitUpdateRequest — Site visit data for PUT operations that replace the entire site visits array
    - `date` string, date
    - `grade` string, required — The grade of the site visit
    - `source` string, required — The source of the site visit information
    - `createdAt` string, date
    - `createdBy` string — The user who created the record
    - `updatedAt` string, date
    - `updatedBy` string — The user who last updated the record
    - `verifiedDate` string, date
    - `verifiedBy` string — The user who verified the site visit
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this site visit
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - SpecialtyUpdateRequest — Specialty data for PUT operations that replace the entire specialties array
    - `specialty` string, required — The specialty of the practitioner
    - `subspecialty` string — The subspecialty of the practitioner
    - `taxonomyCode` string — The NUCC taxonomy code extracted from the specialty display string
    - `primarySpecialty` boolean — Whether this is the primary specialty
    - `source` string, required — The source of the specialty information
    - `type` string, required — The type of specialty
    - `createdAt` string, date
    - `createdBy` string — The user who created the record
    - `updatedAt` string, date
    - `updatedBy` string — The user who last updated the record
    - `verifiedDate` string, date
    - `verifiedBy` string — The user who verified the specialty
    - `attachments` CredentialingWorkflowAttachment[] — Array of attachment metadata for this specialty
      - `createdAt` string — Creation timestamp
      - `fileType` string, required — Document file type
      - `fileUrl` string, required — GCS file URL for file retrieval
      - `originalFileName` string, required — Original file name
      - `expirationDate` string — Expiration date
      - `createdBy` string — User who created the record
  - SupportingDocumentUpdateRequest — Supporting document data for PUT operations using replace-all pattern
    - `fileUrl` string, required — URL of the supporting document file
    - `fileType` string, required — Type of the supporting document
    - `originalFileName` string, required — Original name of the uploaded file
    - `createdAt` string, date
    - `createdBy` string — The user who created the record
    - `state` string — The state associated with the supporting document
    - `expirationDate` string, date
    - `source` string — The source of the supporting document

## Response `201`

Record created successfully

- object

## Other responses

- `400` — Bad request - Invalid section name, input, or validation error
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Credentialing workflow not found
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/versions/3d27e9019c7b/schema)