---
title: "Create user agent notification"
method: POST
path: "/user-agent-notifications"
tags: ["Notifications"]
---

# Create user agent notification

`POST /user-agent-notifications`

Creates a new user agent notification

## Request body

- object
  - `message` string, required — Notification message
  - `objects` integer[], required — Target object IDs
  - `startTime` integer — Start time (Unix epoch seconds)
  - `endTime` integer — End time (Unix epoch seconds)
  - `onStartup` boolean — Show on startup

## Response `200`

Notification created

## Other responses

- `400` — Invalid request
- `401` — Access denied

## Changes

> 15 revisions in range; 12 could not be searched.

- **2023-02-23** `9c09a2aad349` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/netxms/apis/netxms-rest-api/changes/user-agent-notifications/post.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-rest-api/revisions/04789afedcb3/schema)