Post Records
Purpose
To add new entities to a module.
Endpoints
CopiedPOST/{module_api_name}
Request Details
Request URL
{api-domain}/iot/{version}/{module_api_name}
Supported Modules
Devices, Assets, Locations, Alarms, Datapoints, Products, Manufacturers, Vendors, Certificates, Policies, Commands, Users.
Headers
Authorization: Zoho-oauthtoken {{oauth}}
Body raw (json)
{
"assets": {
"name": "DG_Dataflow",
"Time": "1688471523",
"model_id": "331000000133728"
}
}
Scope
scope=ZohoIOT.modules.{module_name}.{operation_type}
Possible module api names
devices, assets, locations, alarms, datapoints, products, manufacturers, vendors, certificates, policies, commands, users.
Possible operation types
ALL - Full access to the record
CREATE - Post records in the module
System defined mandatory field for each module
While inserting records there are a few system-defined mandatory fields that you need to mention. To successfully insert records in Zoho IoT, make sure you enter user-defined mandatory fields too.
Sample Request: First API Call
Copiedcurl --location -g '{{api-domain}}/iot/v1/devices' \
--header 'Authorization: Zoho-oauthtoken {{oauth}}' \
--header 'Content-Type: application/json' \
--data
"devices": {
"name": "tt",
"description": "",
"authentication_security": "Security Token with TLS",
"model_id": "469000000187101"
}
}
Sample Response
Copied{
"devices": [
{
"Modified_Time": "2023-10-12T18:30:36",
"code": "SUCCESS",
"registration_details": {
"device_id": 469000000217007,
},
"$type": "mqtt",
"name": "tt",
"id": "469000000217007",
"Created_By": {
"id": "469000000161019"
},
"status": "success"
}
]
}