# Create Sub Status

`lawmatics_create-sub-status` · Lawmatics MCP tool · Sub Statuses

Create a matter sub status in Lawmatics. The response includes a `relationships` envelope of {id,type} pointers to the creating user and the matters (prospects) carrying this sub status.

## Input

- **name** `string` (required) — Sub status name
- **status** `string` — Matter status this sub status maps to. Valid values: "hired", "pnc", "lost". Defaults to "pnc" server-side when omitted
- **createdById** `string` — ID of the user to record as the creator of this sub status. Write-only; not returned in the response

## Output

- **id** `string` (required) — Lawmatics sub status ID of the newly created sub status
- **name** `string` (required) — Sub status name
- **status** `string` (required) — Matter status this sub status maps to; one of "hired", "pnc", or "lost"
- **createdAt** `string` (required) — When the sub status was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the sub status was last updated, as an ISO 8601 timestamp
- **relationships** `object` (required) — JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (type 'user' -> get-user, type 'prospect' -> get-matter).
  - **createdBy** `object | null` (required) — Creating user pointer; null when unset
    - **id** `string` (required) — ID of the referenced Lawmatics record
    - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
  - **prospects** `array` (required) — Pointers to matters (prospects) carrying this sub status; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool