---
title: "create one or multiple employerNotes"
method: POST
path: "/api/serviceemployment/employerNotes"
tags: ["employerNotes"]
---

# create one or multiple employerNotes

`POST /api/serviceemployment/employerNotes`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/serviceemployment/employerNotes`
- Auth: HTTP bearer

Create one or multiple employerNotes

## Request body

- union
  - EmployerNotePostDto: Employer notes for the employment service
    - `createdAt` string, date-time: Creation timestamp
    - `createdBy` string, uuid: Creator UUID
    - `lastUpdatedAt` string, date-time: Last update timestamp
    - `lastUpdatedBy` string, uuid: Last updater UUID
    - `lastUpdatedByAudience` string: Audience of last updater
    - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater
    - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID
    - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater
    - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater
    - `companyUuid` string, uuid, required: Company UUID
    - `workerUuid` string, uuid, required
    - `authorContext` object, required
      - `audienceUuid` string, uuid, required
      - `userUuid` string, uuid, required
      - `impersonatedBy` string, uuid, nullable
    - `text` string, required
    - `process` 'i9' | 'w4', required: The process that the note is associated with
    - `virtualEmployer` object
      - `uuid` string, uuid, required
      - `firstname` string
      - `lastname` string
      - `email` string, email, required
      - `position` string
      - `avatar` string, uri
      - `hideFromLogNotes` boolean
      - `anonymizeInLogNotes` boolean
    - `virtualUser` object
      - `uuid` string, uuid, required
      - `audienceUuid` string, uuid, required
      - `audience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent', required
      - `authzRoleUuid` string, uuid
      - `authzRole` object
        - `uuid` string, uuid, required
        - `label` string
  - EmployerNotePostDto[]
    - `createdAt` string, date-time: Creation timestamp
    - `createdBy` string, uuid: Creator UUID
    - `lastUpdatedAt` string, date-time: Last update timestamp
    - `lastUpdatedBy` string, uuid: Last updater UUID
    - `lastUpdatedByAudience` string: Audience of last updater
    - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater
    - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID
    - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater
    - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater
    - `companyUuid` string, uuid, required: Company UUID
    - `workerUuid` string, uuid, required
    - `authorContext` object, required
      - `audienceUuid` string, uuid, required
      - `userUuid` string, uuid, required
      - `impersonatedBy` string, uuid, nullable
    - `text` string, required
    - `process` 'i9' | 'w4', required: The process that the note is associated with
    - `virtualEmployer` object
      - `uuid` string, uuid, required
      - `firstname` string
      - `lastname` string
      - `email` string, email, required
      - `position` string
      - `avatar` string, uri
      - `hideFromLogNotes` boolean
      - `anonymizeInLogNotes` boolean
    - `virtualUser` object
      - `uuid` string, uuid, required
      - `audienceUuid` string, uuid, required
      - `audience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent', required
      - `authzRoleUuid` string, uuid
      - `authzRole` object
        - `uuid` string, uuid, required
        - `label` string

## Response `201`

One or many employerNote documents created. Wrapped in a JsonAPI root response.

- object
  - `data` union
    - EmployerNote: Employer notes for the employment service
      - `uuid` string, uuid, required: Unique identifier
      - `createdAt` string, date-time: Creation timestamp
      - `createdBy` string, uuid: Creator UUID
      - `lastUpdatedAt` string, date-time: Last update timestamp
      - `lastUpdatedBy` string, uuid: Last updater UUID
      - `lastUpdatedByAudience` string: Audience of last updater
      - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater
      - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID
      - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater
      - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater
      - `companyUuid` string, uuid, required: Company UUID
      - `workerUuid` string, uuid, required
      - `authorContext` object, required
        - `audienceUuid` string, uuid, required
        - `userUuid` string, uuid, required
        - `impersonatedBy` string, uuid, nullable
      - `text` string, required
      - `process` 'i9' | 'w4', required: The process that the note is associated with
      - `virtualEmployer` object
        - `uuid` string, uuid, required
        - `firstname` string
        - `lastname` string
        - `email` string, email, required
        - `position` string
        - `avatar` string, uri
        - `hideFromLogNotes` boolean
        - `anonymizeInLogNotes` boolean
      - `virtualUser` object
        - `uuid` string, uuid, required
        - `audienceUuid` string, uuid, required
        - `audience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent', required
        - `authzRoleUuid` string, uuid
        - `authzRole` object
          - `uuid` string, uuid, required
          - `label` string
    - EmployerNote[]
      - `uuid` string, uuid, required: Unique identifier
      - `createdAt` string, date-time: Creation timestamp
      - `createdBy` string, uuid: Creator UUID
      - `lastUpdatedAt` string, date-time: Last update timestamp
      - `lastUpdatedBy` string, uuid: Last updater UUID
      - `lastUpdatedByAudience` string: Audience of last updater
      - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater
      - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID
      - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater
      - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater
      - `companyUuid` string, uuid, required: Company UUID
      - `workerUuid` string, uuid, required
      - `authorContext` object, required
        - `audienceUuid` string, uuid, required
        - `userUuid` string, uuid, required
        - `impersonatedBy` string, uuid, nullable
      - `text` string, required
      - `process` 'i9' | 'w4', required: The process that the note is associated with
      - `virtualEmployer` object
        - `uuid` string, uuid, required
        - `firstname` string
        - `lastname` string
        - `email` string, email, required
        - `position` string
        - `avatar` string, uri
        - `hideFromLogNotes` boolean
        - `anonymizeInLogNotes` boolean
      - `virtualUser` object
        - `uuid` string, uuid, required
        - `audienceUuid` string, uuid, required
        - `audience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent', required
        - `authzRoleUuid` string, uuid
        - `authzRole` object
          - `uuid` string, uuid, required
          - `label` string
  - `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)