---
title: "Create a new accountant (super-admin only)"
method: POST
path: "/accountants"
tags: ["Accountants"]
---

# Create a new accountant (super-admin only)

`POST /accountants`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountants`
- Auth: HTTP bearer

Creates a new user + accountant profile. Gated behind a super-admin
email check — only callers whose JWT email matches `SUPER_ADMIN_EMAILS`
(default: augusto@medianfi.com) may invoke this endpoint.

## Request body

- CreateAccountantInput
  - `email` string, email, required
  - `firstName` string, required
  - `lastName` string, required
  - `password` string, required
  - `displayName` string
  - `title` string
  - `credentials` string[]
  - `assignAll` boolean: If true, assign the new accountant to every existing company.

## Response `201`

Accountant created

- CreateAccountantResponse
  - `success` boolean
  - `data` object
    - `accountant` Accountant
      - `id` string, uuid
      - `userId` string, uuid, nullable
      - `displayName` string
      - `title` string, nullable
      - `bio` string, nullable
      - `avatarUrl` string, nullable
      - `credentials` string[]
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `userId` string, uuid
    - `email` string
    - `assignedCompanyCount` integer

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `409`: Email already registered
- `422`: Validation error

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)