Update event notification recipients in bulk

Update recipients for email notifications of an event in bulk.

Only recipients included in this call receive email notificaitons. A recipient who was previously receiving notifications but was not included in this call is removed from the list of recipients receiving notifications.

Request
Security:
path Parameters
eventType
required
string (Event type)

Event type

Enum: "acceleration" "accOff" "accOn" "activated" "button" "collision" "coreConnection" "coverOpened" "deceleration" "distractedDriving" "geoFence" "jolt" "shakingEnded" "shakingStarted" "sharpTurnLeft" "sharpTurnRight" "speedLimit" "powerDisconnectAlarm" "smoking" "foodDrink" "cellPhoneUse" "driverUnbelted" "smokingBeep" "foodDrinkBeep" "cellPhoneUseBeep" "driverUnbeltedBeep" "distractedDriverBeep" "virtualEvent" "wrongPinCode" "gsensorHigh" "gsensorRegular" "accident" "tailgating" "obstruction" "laneWeaving" "possibleFatigue" "qrCode" "standbyEnter" "standbyExit"
Request Body schema: application/json
One of:
organizationId
required
number (Organization ID)

The ID of the organization. Obtain this from GET /organizations.

groupIds
Array of integers (Group ID) non-empty

The IDs of the requested groups. Obtain group IDs from GET /organizations/{orgId}/devices.

notificationRecipients
required
Array of strings <email> (Email)

The recipient emails.

Responses
200

Successful operation

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

500

Internal server error

put/devices/events/{eventType}/notification-recipients
Request samples
application/json
{
  • "organizationId": 17,
  • "groupIds": [
    ],
  • "notificationRecipients": [
    ]
}
Response samples
application/json
{
  • "requestId": "06327cae-e075-42ca-b620-c5cfdd3b4e37"
}