---
title: Create a Device
slug: jetstream-v2/create-a-device
docTags: 
createdAt: 2024-01-23T15:29:21.081Z
---

## About

Add a device to your Jetstream application, making the device ready to receive your commands and push events.

## Parameters

| **Property**                                           | **Location** | **Details**                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **AccessKey**<br />string<br />Required<br />Unique    | Header       | The access key for your user account.<br />This value is a 36-character GUID provided during [user account sign up](https://jetstreamrfid.com/login/signup).                                                                                                                                                                                 |
| **Name**<br />string<br />Required<br />Unique         | Body         | The name of the device.<br />This value has a max length of 128 ASCII characters.<br />This value must adhere to this regular expression: ^\[a-zA-Z0-9-\_]\*$                                                                                                                                                                                |
| **SerialNumber**<br />string<br />Required<br />Unique | Body         | The physical serial number of the device.<br />This value has a max length of 128 ASCII characters.<br />This value must adhere to this regular expression: ^\[a-zA-Z0-9-\_]\*$                                                                                                                                                              |
| **DeviceDefinition**<br />string<br />Required         | Body         | The name of the device definition associated with the device.<br />This value is one of the device definitions retrieved by the [Get All Device Definitions](docId\:XnMyd7X5iixvo71OFVqoz) request.<br />This value has a max length of 128 ASCII characters.<br />This value must adhere to this regular expression: ^\[a-zA-Z0-9-\_,. ]\*$ |
| **Region**<br />string<br />Required                   | Body         | The geographic region that the RFID device is being placed. This is used to create the most reliable and lowest latency connection to the device<br />This value is one of the following possibilities: US, EU, AP, USGOV                                                                                                                    |
| **Policy**<br />string                                 | Body         | The name of the policy associated with the device.<br />This value is set via the [Add a Policy to a Device](docId\:U-YIhQPcNLvud3UaG439E) request. Attempting to set this any other way or not defining this property will result in an empty string value.                                                                                 |

## Example

### Request URL

**POST** https\://api.jetstreamrfid.com/2/devices

### Request Body

:::BlockQuote
\{
&#x20;   "Name": "MyDeviceName",
&#x20;   "SerialNumber": "MyDeviceSerialNumber",
&#x20;   "DeviceDefinition": "TS032, Cabinet, US, UHF, GF, 7.9 cu ft, v4",
&#x20;   "Region": "US"
}
:::

### Response Code

201 Created

### Response Body

:::BlockQuote
\{
&#x20;   "Name": "MyDeviceName",
&#x20;   "SerialNumber": "MyDeviceSerialNumber",
&#x20;   "DeviceDefinition": "TS032, Cabinet, US, UHF, GF, 7.9 cu ft, v4",
&#x20;   "Region": "US",
&#x20;   "Policy": ""
}

:::

## Version Changes

Replaces AddLogicalDevice