Skip to main content
Skip table of contents


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 (pencil) 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




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

Header parameters



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





Response body

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

Example curl

curl '' -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: 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.

JavaScript errors detected

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

If this problem persists, please contact our support.