---
title: "Create a custom device"
method: POST
path: "/devices"
tags: ["Devices"]
---

# Create a custom device

`POST /devices`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/devices`
- Auth: HTTP bearer

Required permission: settings:write. Adds a device of your own, such as a recorder or a script, to the account's devices. Italic does not connect to it: send what it records to POST /recordings with its `id` as `deviceId`. The apps list it under Custom in Devices, where the person can rename or remove it. An account can have 1,000 devices, removed ones included.

## Headers

- `Idempotency-Key` string

## Request body

- CreateDevice
  - `name` string, required: What the apps call the device, such as Kitchen recorder. The person can rename it in the apps.

## Response `200`

Success. Writes without read permission return an ID and revision only.

- DeviceResult
  - `device` Device, required
    - `id` string, required
    - `name` string, required
    - `model` string, required: The device type: `ring`, `glyph`, `dex` or `custom`.
  - `replayed` boolean

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

[API](https://skmtc.dev/italic/apis/italic-api.md) - [All operations](https://skmtc.dev/italic/apis/italic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/italic/apis/italic-api/revisions/2fbe2cf16fe3?raw)