---
title: "Create new Field Permission"
method: POST
path: "/permissions/fields"
tags: ["User & Permission"]
---

# Create new Field Permission

`POST /permissions/fields`

Creates a PermissionField resource.

## Request body

- PermissionFieldCreate
  - `fieldsVisible` string[], required — This array should contains Field Identifiers. While POST or PUT, this array should contain every single value needed, while current values in the payload will replace existing ones.
  - `fieldsEditable` string[], required — This array should contains Field Identifiers. While POST or PUT, this array should contain every single value needed, while current values in the payload will replace existing ones.
  - `users` Identifier[] — This object should contains a collection of user identifiers
  - `id` string, required — This is the unique identifier of the resource
  - `description` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `name` LanguageTranslation, required — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string

## Response `201`

PermissionField resource created

- PermissionFieldPermissionFieldOutput
  - `fieldsVisible` string[] — This array should contains Field Identifiers.
  - `fieldsEditable` string[] — This array should contains Field Identifiers.
  - `name` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `description` LanguageTranslation — This structure does accept key & values where key has to be a language code configured in your PIM & the value is the value for this field in this language.
    - `fr-FR` string
    - `en-US` string
  - `dateCreated` string, date-time, nullable — This is an ISO datetime
  - `dateModified` string, date-time, nullable — This is an ISO datetime
  - `id` string — This is the unique identifier of the resource
  - `users` object[]
    - `id` string — This is the unique identifier of the resource
    - `firstName` string
    - `lastName` string

## Other responses

- `400` — Invalid input
- `422` — Unprocessable entity

---

[API](https://skmtc.dev/quable/apis/quable-pim-api-documentation-v5.md) · [All operations](https://skmtc.dev/quable/apis/quable-pim-api-documentation-v5/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/quable/quable-pim-api-documentation-v5/revisions/1641096abb34/schema)