---
title: "POST /v1/matters"
method: POST
path: "/v1/matters"
tags: ["matters"]
---

# POST /v1/matters

`POST /v1/matters`

Creates a matter with the given name and description. The initial state is open, and the owner is the method caller. Returns the created matter with default view.

## Request body

- Matter — Represents a matter. To work with Vault resources, the account must have the [required Vault privileges] (https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.
  - `description` string — An optional description for the matter.
  - `matterPermissions` MatterPermission[] — Lists the users and their permission for the matter. Currently there is no programmer defined limit on the number of permissions a matter can have.
    - `role` 'ROLE_UNSPECIFIED' | 'COLLABORATOR' | 'OWNER' — The user's role for the matter.
    - `accountId` string — The account ID, as provided by the [Admin SDK](https://developers.google.com/admin-sdk/).
  - `matterRegion` 'MATTER_REGION_UNSPECIFIED' | 'ANY' | 'US' | 'EUROPE' — Optional. The requested data region for the matter.
  - `matterId` string — The matter ID, which is generated by the server. Leave blank when creating a matter.
  - `name` string — The name of the matter.
  - `state` 'STATE_UNSPECIFIED' | 'OPEN' | 'CLOSED' | 'DELETED' — The state of the matter.

## Response `200`

Successful response

---

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