# Add MQTT Device

### Add Device

![Add MQTT Device](/files/OC1pv7VYdmCIh3RIhw9f)

While adding a device, you need to provide following parameters:

* Device Key
* Password for Your Device&#x20;
* Name of Your Device
* Category for Your Device
* Client ID
* Access control topic with pub, sub or pubsub options

#### Device Key

Entered Device Key will be the Username for MQTT Connection. It always starts with the User's Account ID.

#### Password for your Device

Entered password will be considered as password for MQTT Connection.

{% hint style="info" %}
Please make sure you have noted down password because it will not shown anywhere once device get added.
{% endhint %}

#### Name for your Device

User can give a name for a device. Later user can search device by its name.

#### Category for your Device

User can assign a Category for device. It will be helpful for sorting devices by their category.

#### Client ID

Entered client ID will get used for MQTT Connection.

* Case 1: User can provide fixed client ID.&#x20;
* Case 2: If user is dynamically generating client Id in his code,  then he can provide client ID as **\*.**&#x20;
* Case 3: If single MQTT client is used by many devices then user has to keep it as "**\*".**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thingsup.io/mqtt/add-mqtt-device.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
