🧑‍🤝‍🧑Notify device groups

APIs to send push notification to a group of devices in your account, the request only works with account API key.

Your API Key is required for making any requests using our API, you can find it inside the console integrations page (https://push.techulus.com/console/integrations) or Account tab in mobile app. Team API keys can be found in the team details screen.

The authentication header (API Key) to be specified in the request is x-api-key

Send notification to a device group

POSThttps://push.techulus.com/api/v1/notify/group/{groupId}

Authorization

api_key_header

Path parameters

groupId*string

Device Group ID

Body

application/json

Notification

title*string

Notification title

body*string

Notification Body

soundstring

Notification sound, valid options are default, arcade, correct, fail, harp, reveal, bubble, doorbell, flute, money, scifi, clear, elevator, guitar, pop.

channelstring

Notification channel, alphanumerical string and hyphens only.

linkstring

Notification link (URL)

imagestring

Notification image (URL)

timeSensitiveboolean

Time sensitive notifications will be delivered immediately, even if the device is in do not disturb mode. (iOS only)

Response

200400401500

Successful operation

Body

application/json

success*boolean

messagestring

responsesarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://push.techulus.com/api/v1/notify/group/{groupId}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "title": "text",
      "body": "text"
    }),
});
const data = await response.json();

Response

200400401

{
  "success": false,
  "message": "text",
  "responses": [
    {
      "success": false,
      "message": "text"
    }
  ]
}