MQTT data connector configuration object consists of the following attributes:

AttributeDescription
typeConnector type; must be always set to mqtt.
idApp wide unique connector id.
serverProvide only the domain part of the URL without scheme.
portService port number.
sslEither true or false. If true uses TLS connection.
sslConfigOptional Used when server uses a self signed certificate. It consists of two sections: server and client. Each section has its own fields as shown in Test and Create example.
credentialsOptional Username and password to connect to the broker.
clientIdMQTT client id.
topicMQTT topic.
qosQuality of service level, one of qos0, qos1, and qos2.
dataProcessingMethodOptional. Id or name of the App method that will be used for filtering and/or transforming incoming data. See Overview page for details.
disabledOptional. When true data connector stops streaming.
POST .../v3/apps/:ref/dataconnectors/test

{
  "id": "dc.mqtt.notsecure.1",
  "type": "mqtt",  
  "server": "test.mosquitto.org",
  "port": 1883,
  "clientId": "test-jc-2",
  "topic": "test-jc-1",
  "qos": "QoS0",
  "ssl": false,
  "disabled": false
}
POST .../v3/apps/:ref/dataconnectors

{
  "id": "dc.mqtt.notsecure.1",
  "type": "mqtt",  
  "server": "test.mosquitto.org",
  "port": 1883,
  "clientId": "test-jc-2",
  "topic": "test-jc-1",
  "qos": "QoS0",
  "dataProcessingMethod": "processData",
  "ssl": false,
  "disabled": false
}
PUT .../v3/apps/:ref/dataconnectors/dc.mqtt.1

{
  "clientId": "test-client",
  "dataProcessingMethod": "processData"  
}
POST .../v3/apps/:ref/dataconnectors

{
  "type": "mqtt",
  "id": "dc.mqtt.secure",
  "server": "mqtt.connio.cloud",
  "port": 8883,
  "credentials": {
    "user": "someuser",
    "password": "somepwd"
  },
  "clientId": "_client_123123123",
  "topic": "test-1",
  "qos": "qos1",
  "ssl": true,
  "disabled": false
}
POST .../v3/apps/:ref/dataconnectors

{
  "type": "mqtt",
  "id": "dc.mqtt.secure.with.cert",
  "server": "test.mosquitto.org",
  "port": 8883,
  "clientId": "test-jc-2",
  "topic": "test-jc-1",
  "qos": "QoS0",
  "ssl": true,
  "sslConfig": {
    "server": {
      "certificate": "-----BEGIN CERTIFICATE-----\nMIIC8DCCAlmgAwIBAgIJAOD63PlXjJi8MA0GCSqGSIb3DQEBBQUAMIGQMQswCQYD\nVQQGEwJHQjEXMBUGA1UECAwOVW5pdGVkIEtpbmdkb20xDjAMBgNVBAcMBURlcmJ5\nMRIwEAYDVQQKDAlNb3NxdWl0dG8xCzAJBgNVBAsMAkNBMRYwFAYDVQQDDA1tb3Nx\ndWl0dG8ub3JnMR8wHQYJKoZIhvcNAQkBFhByb2dlckBhdGNob28ub3JnMB4XDTEy\nMDYyOTIyMTE1OVoXDTIyMDYyNzIyMTE1OVowgZAxCzAJBgNVBAYTAkdCMRcwFQYD\nVQQIDA5Vbml0ZWQgS2luZ2RvbTEOMAwGA1UEBwwFRGVyYnkxEjAQBgNVBAoMCU1v\nc3F1aXR0bzELMAkGA1UECwwCQ0ExFjAUBgNVBAMMDW1vc3F1aXR0by5vcmcxHzAd\nBgkqhkiG9w0BCQEWEHJvZ2VyQGF0Y2hvby5vcmcwgZ8wDQYJKoZIhvcNAQEBBQAD\ngY0AMIGJAoGBAMYkLmX7SqOT/jJCZoQ1NWdCrr/pq47m3xxyXcI+FLEmwbE3R9vM\nrE6sRbP2S89pfrCt7iuITXPKycpUcIU0mtcT1OqxGBV2lb6RaOT2gC5pxyGaFJ+h\nA+GIbdYKO3JprPxSBoRponZJvDGEZuM3N7p3S/lRoi7G5wG5mvUmaE5RAgMBAAGj\nUDBOMB0GA1UdDgQWBBTad2QneVztIPQzRRGj6ZHKqJTv5jAfBgNVHSMEGDAWgBTa\nd2QneVztIPQzRRGj6ZHKqJTv5jAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBQUA\nA4GBAAqw1rK4NlRUCUBLhEFUQasjP7xfFqlVbE2cRy0Rs4o3KS0JwzQVBwG85xge\nREyPOFdGdhBY2P1FNRy0MDr6xr+D2ZOwxs63dG1nnAnWZg7qwoLgpZ4fESPD3PkA\n1ZgKJc2zbSQ9fCPxt2W3mdVav66c6fsb7els2W2Iz7gERJSX\n-----END CERTIFICATE-----"
        }
    },
 "disabled": false
}

What’s Next