---
search:
  tags:
    - matters
    - POST
seo:
  description: >-
    Create a matter (scope matters:write). Reference for the POST
    /api/v1/matters endpoint in the Basenet Public API.
sidebar:
  label: Create a matter (scope matters:write)
  badge: POST
title: Create a matter (scope matters:write)
type: openapi-operation
---
Endpoint: `POST /api/v1/matters`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Request body (`application/json`):
- `name` (string, required)
- `clientRelationId` (string, required)
- `departmentId` (string, optional)
- `practiceArea` (string, optional)
- `flavor` (one of `"legal"`, `"debt_collection"`, `"insolvency"`, `"roll"`, `"tax_law"`, `"general"`, `"employment_law"`, optional)
- `responsibleRelationId` (string, optional)
- `acknowledgeConflicts` (boolean, optional)

Responses:
- `201`: Created resource
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 201 body (`application/json`):
- `matter` (object, optional)
- `matter.id` (string, required)
- `matter.number` (string, required)
- `matter.name` (string, required)
- `matter.status` (string, required)
- `matter.flavor` (string, required)
- `matter.practiceArea` (string or null, required)
- `matter.departmentId` (string or null, required)
- `matter.accessLevelId` (string or null, required)
- `matter.solicitorResponsibleRelationId` (string or null, required)
- `matter.startDate` (string or null, required)
- `matter.closedDate` (string or null, required)
- `matter.createdAt` (string, required)
- `matter.updatedAt` (string, required)
- `matter.legalAid` (object, optional)
- `matter.legalAid.present` (boolean, required)
- `matter.legalAid.stage` (one of `"none"`, `"requested"`, `"assigned"`, required)
- `matter.legalAid.hourlyFrom` (string or null, required)
- `matter.legalAid.continuesAsHoursMatter` (boolean, required): Deprecated: derived as hourlyFrom !== null. Prefer hourlyFrom for the dated switch.
- `matter.legalAid.filter` (one of `"yes"`, `"no"`, `"hours"`, required)
- `conflicts` (array of object, optional)
- `conflicts[].matterId` (string, required)
- `conflicts[].matterNumber` (string, required)
- `conflicts[].matterName` (string, required)
- `conflicts[].relationId` (string, required)
- `conflicts[].relationName` (string, required)
- `conflicts[].role` (string, required)