---
title: "Claim device (claimDevice)"
method: POST
path: "/api/customer/device/{deviceName}/claim"
tags: ["device-controller"]
---

# Claim device (claimDevice)

`POST /api/customer/device/{deviceName}/claim`

Claiming makes it possible to assign a device to the specific customer using device/server side claiming data (in the form of secret key).To make this happen you have to provide unique device name and optional claiming data (it is needed only for device-side claiming).Once device is claimed, the customer becomes its owner and customer users may access device data as well as control the device. 
In order to enable claiming devices feature a system parameter security.claim.allowClaimingByDefault should be set to true, otherwise a server-side claimingAllowed attribute with the value true is obligatory for provisioned devices. 
See official documentation for more details regarding claiming.

Available for users with 'CUSTOMER_USER' authority.

## Path parameters

- `deviceName` string, required

## Request body

- ClaimRequest — Claiming request which can optionally contain secret key
  - `secretKey` string

## Response `200`

OK

- string

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)