Skip to main content
Skip table of contents

create: projects.locations.registries.devices

Creates a device in a device registry.

Note: This is a regional API.

You can find the URL, SystemKey, and token required in the call by clicking API Keys (key icon) at the top-right of the Registry Details page. Use the Registry Keys section.

HTTP request

POST {URL}/api/v/4/webhook/execute/{SystemKey}/cloudiot_devices

Query parameters

None

Header parameters

Parameters

ClearBlade-UserToken

See the note at the start of this document on where to find the token.

Request body

The request body contains a device instance.

Response status codes

Code

Meaning

200

Success

Response body

If successful, the response body contains a newly created device instance.

Example curl

curl 'https://us-central1.clearblade.com/api/v/4/webhook/execute/aae9b9b30c8aa4e49081c7eeb9bb07/cloudiot_devices' -X POST -H 'ClearBlade-UserToken: {Token}' -d '{"id": "test-device-1", "credentials": [], "config": {}, "metadata": {}, "logLevel": "LOG_LEVEL_UNSPECIFIED"}'

Using the instructions at the start of this document, replace the following: https://us-central1.clearblade.com with your URL. aae9b9b30c8aa4e49081c7eeb9bb07 with your SystemKey. {Token} with your token.

The item id is required in the body. If other items are not provided, they will have default values in the created device. Set the values of id and other items appropriately.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.