ClearBlade IoT Core
ClearBlade IoT Core
Breadcrumbs

create

Creates a device registry.

Note: This is an admin API.

The URL, systemKey, and token this endpoint requires are obtained differently than others. To get those, do the following:

  1. Click the Select project drop-down at the top of the IoT Core UI.

  2. Click the edit icon ( image-20250820-160436.png ) next to the desired project.

  3. Go to the SERVICE ACCOUNTS tab.

  4. If a service account already exists, select it and choose DOWNLOAD CREDENTIALS. If a service account does not exist, create it and select DOWNLOAD CREDENTIALS.

  5. A JSON file will be downloaded to your local machine. Open the file with an editor. Use the systemKey, token, and URL from the file as needed below.

HTTP request

POST {url}/api/v/4/webhook/execute/{systemKey}/cloudiot

Query parameters

Parameters

parent

string

The project and cloud region path. For example, projects/example-project/locations/us-central1.

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 DeviceRegistry instance.

Response status codes

Code

Meaning

200

Success

Response body

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

Example curl

curl 'https://iot.clearblade.com/api/v/4/webhook/execute/aae9b9b30c8aa4e49081c7eeb9bb07/cloudiot?parent=projects/iot-core-test-363819/locations/us-central1' -H 'ClearBlade-UserToken: {token}' -d '{ "id": "two", "eventNotificationConfigs": [], stateNotificationConfig": {}, "mqttConfig": {}, "httpConfig": {}, "logLevel": "NONE", "credentials": [] }'


Using the instructions at the start of this document, replace the following: https://iot.clearblade.com with your URL. aae9b9b30c8aa4e49081c7eeb9bb07 with your systemKey. {token} with your token.

This example’s body contains a registry object with name and id “two.” Replace the registry object with your own.