---
title: "Send notification to group (async)"
method: POST
path: "/api/v1/notifications/send-to-group-async"
tags: ["Notifications"]
---

# Send notification to group (async)

`POST /api/v1/notifications/send-to-group-async`

## Request

- Base URL: `https://wardenpoint.com` (the document declares no server; this is the origin it was published from)
- URL: `https://wardenpoint.com/api/v1/notifications/send-to-group-async`
- Auth: API key in header `X-API-Key`

## Request body

- NotificationGroupSendRequest
  - `group_uuid` string, uuid, required: Which group to page. Everyone in it is a separate delivery with its own outcome — one member being unreachable does not stop the others. The group's own notification settings decide the channel and the ladder; a member's personal settings apply only where the group rule defers to them.
  - `message` string, required: The alert text, as each member will read it. On a voice channel it is also what gets spoken. Keep it self-contained — a human woken at 4am sees this and nothing else.
  - `priority` 'low' | 'normal' | 'high' | 'critical': Which of the group's notification settings applies — that is what picks the channel and the escalation ladder. Defaults to `normal` when omitted.

## Response `202`

Group notification queued

## Other responses

- `401`: API key missing, invalid, revoked or expired.
- `403`: API key lacks the notifications.send ability.
- `404`: The group uuid exists, but not in this company. Deliberately indistinguishable from a typo — the API never confirms that somebody else's group exists.

---

[API](https://skmtc.dev/wardenpoint/apis/wardenpoint-api.md) · [All operations](https://skmtc.dev/wardenpoint/apis/wardenpoint-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wardenpoint/apis/wardenpoint-api/revisions/259ee445728e?raw)