---
title: "Create one or multiple requirements"
method: POST
path: "/api/servicecompliancev2/requirements"
tags: ["requirements"]
---

# Create one or multiple requirements

`POST /api/servicecompliancev2/requirements`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicecompliancev2/requirements`
- Auth: HTTP bearer

## Request body

- union
  - RequirementDtoInput
    - `name` string, required
    - `segmentUuids` string[], required
    - `fulfillmentDocumentTypeUuids` string[], required
    - `status` 'INACTIVE' | 'ACTIVE' | 'ARCHIVED', required
    - `isPapiHireStageOptionType` boolean
    - `multiDocument` boolean
    - `hideFromWorkers` boolean
    - `notifications` object, required
      - `email` boolean, required
      - `sms` boolean, required
      - `admin` object
        - `supervisor` boolean
        - `openingOwner` boolean
        - `adminUserUuids` string[]
    - `type` 'DOCUMENT' | 'BACKGROUND_CHECK'
    - `backgroundCheck` object
      - `provider` 'CHECKR', required
      - `apiKey` string
      - `checkrPackageSlug` string
      - `recollectionEnabled` boolean
      - `recollectionDays` integer
  - RequirementDtoInput[]
    - `name` string, required
    - `segmentUuids` string[], required
    - `fulfillmentDocumentTypeUuids` string[], required
    - `status` 'INACTIVE' | 'ACTIVE' | 'ARCHIVED', required
    - `isPapiHireStageOptionType` boolean
    - `multiDocument` boolean
    - `hideFromWorkers` boolean
    - `notifications` object, required
      - `email` boolean, required
      - `sms` boolean, required
      - `admin` object
        - `supervisor` boolean
        - `openingOwner` boolean
        - `adminUserUuids` string[]
    - `type` 'DOCUMENT' | 'BACKGROUND_CHECK'
    - `backgroundCheck` object
      - `provider` 'CHECKR', required
      - `apiKey` string
      - `checkrPackageSlug` string
      - `recollectionEnabled` boolean
      - `recollectionDays` integer

## Response `201`

One or many requirements documents created.

- object
  - `data` RequirementDto[]
    - `name` string, required
    - `segmentUuids` string[], required
    - `fulfillmentDocumentTypeUuids` string[], required
    - `status` 'INACTIVE' | 'ACTIVE' | 'ARCHIVED', required
    - `isPapiHireStageOptionType` boolean
    - `multiDocument` boolean
    - `hideFromWorkers` boolean
    - `notifications` object, required
      - `email` boolean, required
      - `sms` boolean, required
      - `admin` object
        - `supervisor` boolean
        - `openingOwner` boolean
        - `adminUserUuids` string[]
    - `type` 'DOCUMENT' | 'BACKGROUND_CHECK'
    - `backgroundCheck` object
      - `provider` 'CHECKR', required
      - `apiKey` string
      - `checkrPackageSlug` string
      - `recollectionEnabled` boolean
      - `recollectionDays` integer
    - `uuid` string, required
    - `companyUuid` string, required
    - `hideFromWorkersButSendNotifications` boolean
    - `customAttributes` object, required
      - `expirationDate` object, required
        - `workerCustomAttributeKey` string, required
        - `workerCustomAttributeUuid` string, required
      - `status` object, required
        - `workerCustomAttributeKey` string, required
        - `workerCustomAttributeUuid` string, required
    - `createdAt` string, date-time, required
    - `createdBy` string, required
    - `updatedAt` string, date-time, required
    - `updatedBy` string, required
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `500`: default error response

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)