---
title: "Create an eval. Roles: admin, evaluator member."
method: POST
path: "/api/evals"
tags: ["Evals"]
---

# Create an eval. Roles: admin, evaluator member.

`POST /api/evals`

## Response `200`

OK

- EvalResponseEvalFull
  - `success` boolean
  - `error` string
  - `eval` EvalFull
    - `audit` Audit
      - `createdTime` string, date-time
      - `modifiedTime` string, date-time
      - `modifiedBy` string
    - `evalId` integer
    - `token` string, uuid
    - `evaluatorMemberId` integer
    - `subjectGroupId` integer
    - `subjectMemberId` integer
    - `description` string
    - `summary` string
    - `percentEarned` number
    - `pointsEarned` number
    - `pointsPossible` number
    - `passed` boolean
    - `completeTime` string, date-time
    - `evalForm` EvalFormFull
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `alternateLocales` object
        - `empty` boolean
      - `evalFormId` integer
      - `membershipId` integer
      - `title` string
      - `description` string
      - `body` string
      - `published` boolean
      - `passTypeCode` 'NONE' | 'PERCENTAGE' | 'POINTS'
      - `passThresholdValue` number
      - `typeCode` 'GROUP_TYPE'
      - `subjectTypeCode` 'GROUP' | 'GROUP_MEMBER' | 'GROUP_MEMBER_SELF'
      - `evaluatorEmailEnabled` boolean
      - `subjectEmailEnabled` boolean
      - `tasksEnabled` boolean
      - `previewEnabled` boolean
      - `descriptionEnabled` boolean
      - `summaryEnabled` boolean
      - `modifyCompletedEvalAllowed` boolean
      - `groupType` GroupTypeCore
        - `audit` Audit
          - `createdTime` string, date-time
          - `modifiedTime` string, date-time
          - `modifiedBy` string
        - `groupTypeId` integer
        - `membershipId` integer
        - `name` string
        - `namePlural` string
        - `description` string
        - `properties` GroupTypeProperties
          - `announcementsHtml` string
          - `chatEnabled` boolean
          - `chatDefaultEnabled` boolean
          - `contactSharingDefaultEnabled` boolean
          - `postsEnabled` boolean
          - `postsDefaultEnabled` boolean
        - `root` boolean
        - `external` boolean
        - `isPrivate` boolean
      - `evaluatorAudience` AudienceCore
        - `audit` Audit
          - `createdTime` string, date-time
          - `modifiedTime` string, date-time
          - `modifiedBy` string
        - `audienceId` integer
        - `membershipId` integer
        - `name` string
        - `criterionType` 'COMPOUND' | 'COURSE' | 'GROUP' | 'IDENTITY_PROVIDER' | 'PROFILE_QUESTION' | 'PROGRAM'
        - `criterionOperator` 'AND' | 'OR' | 'EQUALS' | 'NOT_EQUALS'
        - `criterionValue` string
        - `invalidTime` string, date-time
        - `groupDescendantsIncluded` boolean
        - `idpPluginId` integer
      - `locale` string
    - `responses` UserProfileResponseCore[]
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `userProfileResponseId` integer
      - `profileQuestionId` integer
      - `userMembershipId` integer
      - `activitySubmissionId` integer
      - `evalId` integer
      - `eventRegistrationId` integer
      - `selfReportId` integer
      - `responses` string[]
      - `fileUuids` string[]
      - `responderComment` string
      - `imageUuids` string[]
      - `pointsEarned` number
    - `evaluatorMember` MemberSlim
      - `userMembershipId` integer
      - `membershipId` integer
      - `username` string
      - `firstName` string
      - `middleName` string
      - `lastName` string
      - `email` string
      - `phone` string
      - `membershipNumber` string
      - `fullName` string
      - `isPrimary` boolean
    - `subjectGroup` GroupCore
      - `audit` Audit
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `modifiedBy` string
      - `groupId` integer
      - `groupType` GroupTypeCore
        - `audit` Audit
          - `createdTime` string, date-time
          - `modifiedTime` string, date-time
          - `modifiedBy` string
        - `groupTypeId` integer
        - `membershipId` integer
        - `name` string
        - `namePlural` string
        - `description` string
        - `properties` GroupTypeProperties
          - `announcementsHtml` string
          - `chatEnabled` boolean
          - `chatDefaultEnabled` boolean
          - `contactSharingDefaultEnabled` boolean
          - `postsEnabled` boolean
          - `postsDefaultEnabled` boolean
        - `root` boolean
        - `external` boolean
        - `isPrivate` boolean
      - `membershipId` integer
      - `name` string
      - `properties` GroupProperties
        - `chatEnabled` boolean
        - `postsEnabled` boolean
      - `nodeActive` boolean
      - `ancestryActive` boolean
      - `active` boolean
      - `root` boolean
      - `external` boolean
      - `externalReferenceId` string
    - `subjectMember` MemberSlimWithGuardians
      - `userMembershipId` integer
      - `membershipId` integer
      - `username` string
      - `firstName` string
      - `middleName` string
      - `lastName` string
      - `email` string
      - `phone` string
      - `guardians` MemberSlim[]
        - `userMembershipId` integer
        - `membershipId` integer
        - `username` string
        - `firstName` string
        - `middleName` string
        - `lastName` string
        - `email` string
        - `phone` string
        - `membershipNumber` string
        - `fullName` string
        - `isPrimary` boolean
      - `membershipNumber` string
      - `fullName` string
      - `isPrimary` boolean

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/mobilecoach/apis/untitled-api.md) · [All operations](https://skmtc.dev/mobilecoach/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mobilecoach/untitled-api/revisions/f2568e11c0ab/schema)