---
title: "POST /v1/{+parent}/permissions:batchCreate"
method: POST
path: "/v1/{+parent}/permissions:batchCreate"
tags: ["notes"]
---

# POST /v1/{+parent}/permissions:batchCreate

`POST /v1/{+parent}/permissions:batchCreate`

Creates one or more permissions on the note. Only permissions with the `WRITER` role may be created. If adding any permission fails, then the entire request fails and no changes are made.

## Path parameters

- `parent` string, required

## Request body

- BatchCreatePermissionsRequest — The request to add one or more permissions on the note. Currently, only the `WRITER` role may be specified. If adding a permission fails, then the entire request fails and no changes are made.
  - `requests` CreatePermissionRequest[] — The request message specifying the resources to create.
    - `parent` string — Required. The parent note where this permission will be created. Format: `notes/{note}`
    - `permission` Permission — A single permission on the note. Associates a `member` with a `role`.
      - `group` Group — Describes a single Group.
        - `email` string — The group email.
      - `deleted` boolean — Output only. Whether this member has been deleted. If the member is recovered, this value is set to false and the recovered member retains the role on the note.
      - `name` string — Output only. The resource name.
      - `role` 'ROLE_UNSPECIFIED' | 'OWNER' | 'WRITER' — The role granted by this permission. The role determines the entity’s ability to read, write, and share notes.
      - `family` Family — Describes a single Google Family.
      - `email` string — The email associated with the member. If set on create, the `email` field in the `User` or `Group` message must either be empty or match this field. On read, may be unset if the member does not have an associated email.
      - `user` User — Describes a single user.
        - `email` string — The user's email.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/keep.md) · [All operations](https://skmtc.dev/google/apis/keep/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/keep/revisions/302ce571469e/schema)