---
title: "REST API: Notifications"
type: "wiki"
space: "Axero Documentation"
author: "Anonymous User"
created: 2019-12-03T18:52:21Z
updated: 2026-09-09T03:13:16Z
tags: ["API"]
url: "https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/35671/rest-api-notifications"
---

# REST API: Notifications

[Open API Guide](https://my.axerosolutions.com/spaces/5/axero-documentation/api-guide?id=35671)

Send targeted notifications to specific users or roles. Support for rich-text headers, deep-linking to community content, and custom action buttons within notification alerts.

## Available Endpoints

| Method | Endpoint | Description |
| :--- | :--- | :--- |
| PUT | [Configure Chat Notifications Sound](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/29881/api)<br>`/api/users/me/notifications/soundstatus` | Enable or disable the current user's chat notification sound |
| GET | [Get Announcements](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/35534/api)<br>`/api/announcements` | Enables administrators and developers to programmatically retrieve a list of announcements. For a space the caller is not a member of, the list is empty unless the caller is a site administrator; SpaceID 0 returns the site-level announcements. |
| GET | [Get Notifications](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/22580/api)<br>`/api/notifications` | Retrieves a paginated list of notifications for the authenticated user. Results can be filtered by date range, sender, entity type, category, and read status. |
| GET | [Get Unread Notifications](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/30009/api)<br>`/api/notifications/unread` | Enables administrators and developers to programmatically retrieve unread notifications for the current user. |
| POST | [Read Notifications](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/35532/api)<br>`/api/notifications/read` | Mark your notifications as read. ResponseData is true; the notifications marked are always the calling user's own. |
| POST | [Send Custom Notification](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/35628/api)<br>`/api/notifications` | Send a custom notification to specific people. ResponseData is true when the notification was sent. |
| POST | [Send Notification](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/33080/api)<br>`/api/notifications` | Send a notification about an activity on a piece of content to specific people. ResponseData is true when the notification was sent. |
| POST | [Add Custom Notification](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/113370/api)<br>`/api/notifications/custom` | Notify a persona, a site role, a whole space, or a list of people, and deliver the same message as an in-app notification, an email, a wall post, a Slack message, and a Microsoft Teams message. |