---
title: "Sends a stakeholder message to the recipients. Recipients can either be User/team or both."
method: POST
path: "/api-public/v1/stakeholders/sendMessage"
tags: ["Stakeholders"]
---

# Sends a stakeholder message to the recipients. Recipients can either be User/team or both.

`POST /api-public/v1/stakeholders/sendMessage`

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Request body

- StakeholderMessage — Stakeholder message. At least one recipient required, either a user or a team.
  - `title` string, required — Title of the message.
  - `message` string, required — Message to be sent.
  - `incidentId` integer, required — A valid incident id.
  - `recipients` string[], required — An array of Username. (Can be an empty array.)
  - `recipientTeams` string[] — An array of Team Slugs. Ex- ["team-rCKs6SDCfvC4tRu"]. (Can be an empty array.)

## Response `200`

Status success.

- object — Empty body.

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Path not found
- `429` — Rate-limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/victorops/apis/victorops-api.md) · [All operations](https://skmtc.net/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)