---
title: "Create an ACU"
method: POST
path: "/orgs/{orgId}/acus"
tags: ["orgs/acus"]
---

# Create an ACU

`POST /orgs/{orgId}/acus`

__JWT is required for this endpoint with at least one of the following scopes__: o{params.orgId}-hw:w,o{params.orgId}-quickStart:w,o{params.orgId}-admin:w,o:w,s-o:w<br/><br/>__Endpoint name__: createAcu

## Path parameters

- `orgId` integer, required

## Request body

- object
  - `name` string, required
  - `acuModelId` integer
  - `serialNumber` string, nullable
  - `softwareVersionNumber` string, nullable
  - `isVirtual` boolean, nullable
  - `notes` string, nullable
  - `isGatewayMode` boolean, nullable

## Response `201`

Created

- object
  - `data` object
    - `id` integer, required
    - `name` string
    - `opal` string
    - `hostname` string
    - `thingName` string
    - `serialNumber` string, nullable
    - `serialNumberBrief` string, nullable
    - `softwareVersionNumber` string, nullable
    - `org` object
      - `id` integer, required
      - `name` string
    - `ownedByOrg` object
      - `id` integer, required
      - `name` string
    - `acuModel` object, nullable
      - `id` integer, required
      - `name` string
      - `isBaseModel` boolean
      - `acuModelVendor` object
        - `id` integer, required
        - `name` string
        - `code` string
    - `expansionBoards` object[]
      - `id` integer, required
      - `number` number
      - `acuModel` object
        - `id` integer, required
        - `name` string
        - `isBaseModel` boolean
        - `acuModelVendor` object
          - `id` integer, required
          - `name` string
          - `code` string
      - `mercuryScp` object
        - `id` integer, required
        - `ipAddress` string
        - `ipPort` integer
        - `isEnabled` boolean
        - `isTlsEnabled` boolean
        - `mercuryScpPorts` object[], required
          - `id` integer, required
          - `type` 'internal' | 'rs-485' | 'ethernet', required
          - `number` integer, required
          - `baudRate` 0 | 9600 | 19200 | 38400 | 115200, required
          - `replyTimeoutMilliseconds` 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 500 | 510 | 520 | 530 | 540 | 550 | 560 | 570 | 580 | 590 | 600 | 610 | 620 | 630 | 640 | 650 | 660 | 670 | 680 | 690 | 700 | 710 | 720 | 730 | 740 | 750 | 760 | 770 | 780 | 790 | 800 | 810 | 820 | 830 | 840 | 850 | 860 | 870 | 880 | 890 | 900 | 910 | 920 | 930 | 940 | 950 | 960 | 970 | 980 | 990 | 1000 | 1010 | 1020 | 1030 | 1040 | 1050 | 1060 | 1070 | 1080 | 1090 | 1100 | 1110 | 1120 | 1130 | 1140 | 1150 | 1160 | 1170 | 1180 | 1190 | 1200 | 1210 | 1220 | 1230 | 1240 | 1250 | 1260 | 1270 | 1280 | 1290 | 1300 | 1310 | 1320 | 1330 | 1340 | 1350 | 1360 | 1370 | 1380 | 1390 | 1400 | 1410 | 1420 | 1430 | 1440 | 1450 | 1460 | 1470 | 1480 | 1490 | 1500, required
          - `protocol` integer, required
          - `dialect` integer, required
        - `mercurySio` object
          - `id` integer, required
          - `portNumber` integer
          - `address` integer
          - `scpExpansionBoardId` integer, required
      - `mercurySio` object
        - `id` integer, required
        - `portNumber` integer
        - `address` integer
        - `scpExpansionBoardId` integer, required
    - `certOpal` string, nullable
    - `iotCertOpal` string, nullable
    - `awsIotCertArn` string, nullable
    - `createdAt` string, date
    - `updatedAt` string, date
    - `isVirtual` boolean, nullable
    - `isGatewayMode` boolean, nullable
    - `status` string
    - `statusAt` string, date, nullable
    - `statusMessage` string, nullable
    - `entryCount` integer
    - `shadow` object
      - `error` string
      - `state` object
      - `metadata` object
      - `version` integer
      - `timestamp` integer
    - `enterpriseVpnConfig` object, nullable
      - `isEnterpriseVpnEnabled` boolean
      - `region` string
    - `meson` object
      - `task` object
        - `maintenance` object
    - `notes` string, nullable
    - `acuPorts` object[]
      - `acuPortTypeId` integer
      - `opvideoDevice` object, nullable
        - `id` integer, required
    - `acuShadowState` object, nullable
      - `gluonFirmwareVersion` string, nullable
      - `ionVersion` string, nullable
      - `mesonVersion` string, nullable
      - `mesonAcuVersion` string, nullable
      - `mesonQuicklimeVersion` string, nullable
      - `neutronFirmwareVersion` string, nullable
      - `nucleonVersion` string, nullable
      - `opSerialNumber` string, nullable
      - `photonVersion` string, nullable
      - `protonVersion` string, nullable
      - `quarkVersion` string, nullable
      - `videoFirmwareVersion` string, nullable
      - `videoFirmwareVendor` string, nullable
      - `phosphorusVersion` string, nullable
      - `cydoniaVersion` string, nullable
      - `distroVersion` string, nullable
      - `videoEmmcWearPercent` number, nullable
      - `lastPublishedAt` string, date, nullable
      - `lastUnlockAttemptAt` string, date, nullable
  - `meta` object
    - `accessToken` object, nullable
      - `scopeUpdatedAt` string, date
    - `siteSpecificAccess` object, nullable
      - `isSiteSpecific` boolean
      - `siteIds` integer[], nullable
      - `siteIdsByScope` object, nullable
        - `string` integer[], nullable

---

[API](https://skmtc.net/openpath/apis/openpath-api-documentation.md) · [All operations](https://skmtc.net/openpath/apis/openpath-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openpath/openpath-api-documentation/versions/d8a888c114fa/schema)