---
title: "Add user"
method: POST
path: "/api/v1/users/add"
tags: ["Users"]
---

# Add user

`POST /api/v1/users/add`

## Request body

- object
  - `individual_id` integer
  - `organisation_id` integer
  - `role_id` integer
  - `disabled` boolean
  - `username` string
  - `password` string

## Response `200`

User response

- User
  - `id` integer
  - `uuid` string, uuid
  - `username` string
  - `role_id` integer
  - `individual_id` integer
  - `disabled` boolean
  - `created` string, datetime
  - `modified` string, datetime
  - `organisation_id` integer
  - `organisation` Organisation
    - `id` integer
    - `uuid` string, uuid
    - `name` string
    - `url` string
    - `nationality` string, nullable
    - `sector` string, nullable
    - `type` string, nullable
    - `contacts` string, nullable
    - `created` string, datetime
    - `modified` string, datetime
    - `tags` Tag[]
      - `id` integer
      - `name` string
      - `namespace` string, nullable
      - `predicate` string, nullable
      - `value` string, nullable
      - `colour` string
      - `text_colour` string
      - `counter` integer
      - `created` string, datetime
      - `modified` string, datetime
    - `aligments` Alignment[]
  - `individual` Individual
    - `id` integer
    - `uuid` string, uuid
    - `email` string, email
    - `first_name` string
    - `last_name` string
    - `full_name` string
    - `position` string
    - `tags` Tag[]
      - `id` integer
      - `name` string
      - `namespace` string, nullable
      - `predicate` string, nullable
      - `value` string, nullable
      - `colour` string
      - `text_colour` string
      - `counter` integer
      - `created` string, datetime
      - `modified` string, datetime
    - `aligments` Alignment[]
    - `created` string, datetime
    - `modified` string, datetime
  - `role` Role
    - `id` integer
    - `name` string
    - `is_default` boolean
    - `perm_admin` boolean
    - `perm_sync` boolean
    - `perm_org_admin` boolean

## Other responses

- `403` — Authentication failed. Please make sure you pass the API key of an API enabled user along in the Authorization header.
- `405` — Method not allowed. Your User Role is not allowed to access this resource.
- `default` — Unexpected API error

## Changes

- **2022-01-17** `8e8aed2e396b` — 3 info
  - added the optional property `individual` to the response with the `200` status
  - added the optional property `organisation` to the response with the `200` status
  - added the optional property `role` to the response with the `200` status
- **2022-01-10** `8c8e25f63b66` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api/changes/api/v1/users/add/post.md)

---

[API](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api.md) · [All operations](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api/revisions/90789d145645?raw)