# Create matter

Creates a new matter with the supplied values

Endpoint: POST /v1/matters
Version: 1.0

## Request fields (application/json-patch+json):

  - `name` (string,null)
    Name of the matter

  - `categoryId` (integer, required)
    To retrieve categories ref: /mattercategories

  - `organisationId` (integer,null)
    Leave null for default organisation

  - `fields` (object,null)
    To retrieve fields for matter creation ref: mattercategories/{categoryId}/createSchema
Fields without grouping example serialization: "fields":{ "field_[fieldId]":null, "field_[fieldId]":false }
Fields with grouping example serialization: "fields":{ "group_[groupId]": { "field_[fieldId]":null, "field_[fieldId]":false } }

  - `restricted` (boolean)
    Is the matter restricted

  - `urgent` (boolean)
    Is the matter urgent

  - `parentId` (integer,null)

  - `managerId` (string,null)
    Optionally set the Manager of the new Matter

  - `ownerId` (string,null)
    Optionally set the Owner of the new Matter

  - `externalId` (string,null)
    Optionally set an ID from an external system. Uniqueness is enforced for your organisation

  - `teamId` (integer,null)
    Set the team assignment. This can be required [ref:MatterTemplate.TeamRequired]