# Connect a device (https://logable.app/docs/guides/devices/connect-a-device)

Add the device in the app, copy its token once, and send the first reading over HTTP or MQTT.



A device is one piece of equipment that sends readings to Logable, such as a silo or a belt scale. Connecting one takes four steps in the app, then one request from the device itself.

1. Open **Devices** and select **Add Device**.
2. Step 1, **Device Type**: search for the device type that matches your equipment, or select "Show all types" to browse every type.
3. Step 2, **Details**: give the device a name your team will recognise, such as Raw Meal Silo. Add a Location and a Serial Number if you have them. Turn on Enable status tracking so Logable flags a device that stops reporting.
4. Step 3, **Configuration**: this depends on the device type. A silo asks for a capacity and a weight unit. Configuration tells Logable how to read values. It is not sent with a reading.
5. Step 4, **Credentials**: Logable shows the Device ID and the Device Token. The token is shown once. Copy it now. The REST API and MQTT tabs below give the exact host, port and topic for this device. Select **Download Credentials** to save everything as a file, then select **Done**.

> **Who can do this**

Adding a device needs the admin or the owner role. A member or a viewer can see the device once it exists, but cannot add one.

<Figure src="/docs/captures/add-device-credentials.webp" alt="The Credentials step of the Add Device wizard, showing the Device ID and Device Token fields" width="1344" height="1620" sizes="(min-width: 1280px) 860px, (min-width: 640px) 90vw, 100vw" caption="The Credentials step. The token shows once, on this screen only." />

## Send a reading [#send-a-reading]

Nothing appears on a dashboard until the device sends a value. Follow [Send your first reading](/docs/integrate/quickstart) to post one from a laptop. See [Send readings over HTTP](/docs/integrate/rest-api) or [Publish readings over MQTT](/docs/integrate/mqtt) for the full reference.

## Check it arrived [#check-it-arrived]

Open the device's **Overview** tab. The reading appears without a refresh.

If nothing appears, open the **Connection** tab and use the Device log. It shows what the device sends, what was accepted, and what was rejected and why, as it happens.

<Figure src="/docs/captures/device-connection-tab.webp" alt="A device's Connection tab, showing Connection Details with the HTTP endpoint and a curl example" width="1400" height="681" sizes="(min-width: 1280px) 860px, (min-width: 640px) 90vw, 100vw" caption="The Connection tab, with the endpoint and a worked curl example." />

## Next [#next]

* [Send your first reading](/docs/integrate/quickstart)
* [Rotate or revoke a device token](/docs/guides/devices/rotate-or-revoke-a-device-token)
* [Device types](/docs/reference/device-types)