# /systems - Create system

**POST /systems**

Create a new system. Users can create systems for organizations they can manage based on hierarchical permissions. The organization_id must be specified in the request.


## Servers
- Backend API server: https://my.nethesis.it/backend/api (Backend API server)


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)

- **name** (string)
  System name

- **organization_id** (string)
  Organization Logto ID to associate the system with (use the logto_id from organization responses)

- **custom_data** (object)
  Custom system data (optional)

- **notes** (string)
  Additional notes or description for the system (optional)

- **created_by_organization_id** (string)
  Optional. Attributes the new system's created_by display org to an ancestor org (a reseller or distributor) instead of the caller's own org — used when an upper tier creates a system on behalf of a lower one (e.g. bulk import). Honored only for owner or distributor callers, with the target within the caller's hierarchy. Display/audit only: system ownership and visibility stay governed by organization_id. Empty = attributed to the caller's organization. When set, the created_by snapshot in responses shows the attributed org and carries on_behalf_of: true.

- **created_at** (string(date-time))
  Optional. Creation timestamp the system already has in an external source of record (e.g. a bulk import), used instead of the API call time. Honored only for owner or distributor callers; cannot be in the future.

- **registered_at** (string(date-time))
  Optional. Registration timestamp the system already has in an external source of record. The system is created already registered, so POST /api/systems/register is not needed (and would return 409). Honored only for owner or distributor callers; cannot be in the future or precede created_at.



## Responses
### 201
System created successfully

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)


### 400
Bad request - validation error

#### Body: application/json (object)
- **code** (integer)
  HTTP error code

- **message** (string)
  Error message

- **data** (object)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)