General

• How do I update the data Interval of a device?

  The Data Interval specifies how often a device is expected to send data. This is used to determine how to automatically aggregate the data on graphs. For example, if a device is expected to send 30-minute data, setting the Data Interval to 30 minutes will ensure data is aggregated 30-minutely on graphs wherever possible. If a device only sends data daily it would not make sense to aggregate the data 30-minutely; instead, showing data aggregated daily would make more sense. ||| Changing the DataFew readers

• How do I create an API user and API key?

  You can create an API user in cThings Cloud to programmatically access your devices and data via the cThings Cloud API. You can create API keys once the API user is created. Creating an API user in cThings Cloud Navigate to Users Click New User Select API User Enter a Name and Organisation for your API user Select a Role for your API user; this will determine what API endpoints the API user can access Select an Asset that your API user can access (more assetsFew readers

• How do I move an Asset?

  An asset and all child assets, devices and network nodes can be moved around the hierarchy in cThings Cloud or using the cThings Cloud API. ||| An Asset may also be referred to as an Entity To move an asset around the hierarchy in cThings Cloud: Navigate to the Asset Go to the Asset menu and select Move Select a new Parent Asset for the Asset to be moved ![Moving an Asset in cThings Cloud](https://storage.crisp.chat/users/helpdesk/website/66a70a6ed8fbb400/moving-an-asset-in-ctFew readers

• How do I create a new device

  Creating a new device in cThings Cloud allows you to manage and monitor devices seamlessly. This guide will walk you through the process step-by-step, ensuring your device is set up correctly. || To create a new device, you must have the Device Administrator role with the necessary permissions. Steps to Create a New Device Access the Devices Page Navigate to the Devices page in cThings Cloud by clicking Devices from the menu on the left-hand side. Click the *Few readers

• How do I use Alerts

  Alerts in cThings Cloud notify you about specific events or changes related to your devices. You can enhance your alerts by adding conditions, schedules, and notifications, ensuring you're informed when the right circumstances occur. This guide will walk you through the steps to create an alert and customise it with conditions, schedules, and notifications. Steps to Create a New Alert Creating a new alert in cThings Cloud is quick and straightforward. The process allows you to define when aFew readers

• How do I view data for a device?

  If you need to access historical data for a device in cThings Cloud, you can easily view it by selecting a specific date range. Follow these steps to view and analyse the data for your device. Steps to view data for a device Navigate to the device page Click on the Data tab Select a start date from the Start Date dropdown Select an end date from the End Date dropdown ![Viewing device data on a graph](https://storage.crisp.chat/users/helpdesk/website/66a70a6ed8fbb400Few readers

• How do I link a pulse counter device?

  Configuring a pulse counter in cThings Cloud ensures accurate measurement and tracking of pulse-based readings, such as water or gas meters. Follow the steps below to set up your pulse counter correctly. Prerequisites Before configuring the pulse counter, you must create the meter that will be linked to it. If you haven’t done this yet, follow our guide on How to create a new device. Steps to link a pulse counFew readers

• How do I update the name and serial of a device?

  The device name is useful for providing a friendly and recognisable label for your devices, whereas the device serial (referred to simply as the device) is used as a unique reference against which to load data. While the name can be changed, the device serial cannot be changed. ||| If you need to the device serial, either delete and recreate your device or contact cThings Support Update the Device Name 1. Navigate to the Device and Edit the Device Navigate to the device in cThingFew readers

• Why can’t I see the live chat icon?

  If you can't see the live chat icon on our cThings Cloud, it's most likely because you haven't accepted the cookies required to enable the chat feature. In this article, we'll explain how to accept cookies and get the live chat working. What Are Cookies? Cookies are small pieces of data stored on your device by websites. They are used to enhance your browsing experience, remember your preferences, and enable certain features, such as live chat. How to Accept Cookies To see the live chaFew readers

• How do I create a new Asset

  An asset is a key part of the hierarchy in cThings Cloud. It helps you stay organised by allowing you to group devices under an asset. This guide will walk you through the process of creating a new asset. Steps to Create a New Asset Access the Hierarchy Page Navigate to the Hierarchy page in cThings Cloud by clicking Hierarchy from the menu on the left-hand side. Click the New Asset button in the top-right corner. This will open the asset creation process in a modFew readers

• How do I create a new user?

  Creating a new user in cThings Cloud is a straightforward process. Follow the steps below to add a new user to your account. || To create new users, you need the User Administrator role Steps to Create a New User Access the Users Page Navigate to the Users page in **cThings Cloud **by clicking users from the menu on the left-hand side. Click the New User button in the top-right corner. This opens the user creation process in a modal window. ![Click the new user buttFew readers

• How do I change the default graph for a device?

  Customising the default graph for a device allows you to tailor the displayed data to better suit your needs. Whether you want to focus on specific values or adjust the visualisation, this article will guide you through the steps to change the default graph quickly and easily. Steps to change the default graph for a device Navigate to the device page Click on the Data tab Click on the **Edit Graph **button on the right-hand side of the graph ![Changing the default graph by cliFew readers

• How do I delete a device?

  You can delete a device in cThings Cloud via the device page. You must first Factory Reset the device to delete all data. || To factory reset and delete a device, you must have the Device Administrator role with the necessary permissions. Factory Reset the Device Navigate to the device page From the **Device **menu (top-right corner) click Factory Reset Enter the device serial and click Factory Reset Device ![Factory Reset a Device](https://storage.crisp.chat/users/helpdeFew readers

cThings Cloud API

• How do I use the cThings Cloud API?

  The cThings Cloud API provides programmatic access to functionality and data available via cThings Cloud. The cThings Cloud API is a REST API that exchanges JSON data and is protected by OAuth2. This article outlines how to request an access token from the cThings AuthServer; how to use this token to make a request to the cThings Cloud API; and provides a list of available endpoints. || You can find a Postman collection for the cThings Cloud API here: https://www.postman.com/cthings SecuritPopular

Webhooks and Integrations

• How do I create a webhook?

  What are webhooks? Webhooks allow you to subscribe to data events for a device in cThings Cloud. Every time data is received for a device, a HTTP request is made to an endpoint defined by you. This endpoint must be secure (HTTPS) and handle the transmitted data as specified below. Your webhook endpoint should look similar to the following example. https://webhooks-events.cthings.cloud The following HTTP methods are supported: DELETE GET PATCH POST PUT ![Creating a webhookSome readers

Advanced Customisation

• How do I use a custom domain (URL) with cThings Cloud?

  || If you're interested in whitelablling cThings Cloud with your own custom domain be sure to contact our support team first Pointing your custom domain to cThings Cloud Create a CNAME record for your custom domain using the DNS tools provided by your DNS provider. The value of your CNAME record should point to our load balancer as detailed below. Name Type Value | customdomain.com | CNAME | euw1-cthings-alb01-1847005867.eu-west-1.elb.amazonawsFew readers

Troubleshooting

• What should I do if my webhooks aren't working?

  What are webhooks Webhooks can be used to automatically forward data to a HTTP destination of your choice whenever data is received in cThings Cloud. This can be useful to integrate a third-party application with a direct feed of data from your devices. Why is my webhook not triggering? Webhooks will only trigger for active devices. If you device is inactive, your webhook will not trigger. Testing webhooks You can test webhooks directly from a device in cThings Cloud. Navigate toFew readers

• How do I download data for a device?

  You can export all historical data associated with a device through the cThings Cloud platform. ||| Note: exported data will be saved as a .csv file, which can either be opened using a text editor or a number processor such as Excel Downloading data for a device Accessing the historical data for a device Navigate to your device within cThings Cloud. Select the Data tab located at the top of the device page. ![](https://storage.crisp.chat/users/helpdesk/website/-/6/6/a/7Few readers

• How can I replace an existing meter?

  If you have replaced a meter, you will need to update cThings Cloud to ensure data continues to load. ||| Important: Ensure that both the new and old device serial numbers are correct before proceeding. Replacing the wrong device may result in data inconsistencies or loss of data. Replacing an existing device Navigate to the new device Navigate to the new device page and open the Device dropdown menu in the top-right corner. Select Move from the list. ![](https://stFew readers

• How do I add tags to an asset, device or network node?

  Tags allow you to add extra context or metadata to your assets, devices, and network nodes in cThings Cloud. They can make it easier to filter, group, and analyse data in reports - especially when working with a large number of devices. Adding tags to assets, devices and network nodes | Tags are a great way to group devices for reporting, analytics, and automation workflows - for example, by project, location, or function. Access the configuration page Search for your asset, devicFew readers

• How do I add webhooks to devices?

  In cThings Cloud, you can configure webhooks for your devices to automatically send their data to an HTTP endpoint that you manage. ||| Always ensure your webhook endpoint is secure (HTTPS with authentication), robustly available, and can handle retries, duplicate payloads, and payload size changes to avoid data loss, security risks, or processing errors. For steps on adding webhooks in bulk, see the section further down this page. Adding a webhook to a device || If you’d like to creatFew readers