Skip to main content
POST
/
devices
/
messages
curl --request POST \
  --url https://dashboard.hologram.io/api/1/devices/messages \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "orgid": 98765,
  "deviceids": [
    4020513,
    4020514
  ],
  "data": "Hello from cloud!",
  "protocol": "TCP",
  "port": 80
}
'
{
  "data": [
    {
      "Devicesid": 1234,
      "messageid": "9a9e55f0"
    }
  ],
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.hologram.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

HTTP Basic authentication using API keys. Set the username to apikey and the password to your API key.

You can find your API key on the Hologram Dashboard under Account Settings.

Query Parameters

​
orgid
integer
Example:

144

Body

application/json
​
deviceids
integer[]
required

Device IDs of recipient devices

​
port
integer
required

Port to use for the message

​
protocol
enum<string>
required

Protocol to use: 'TCP' or 'UDP'

Available options:
TCP,
UDP
​
orgid
integer

Organization ID

​
base64data
string

The data to send, encoded in base64. Max length of 10k bytes. Must send either data or base64data

​
data
string

Data to send. Max length of 10k bytes. Must send either data or base64data

Response

OK

​
data
object[]
​
success
boolean

Whether the request was successful or not

Example:

true