---
title: "Send a chat message into VictorOps"
method: POST
path: "/api-public/v1/chat"
tags: ["Chat"]
---

# Send a chat message into VictorOps

`POST /api-public/v1/chat`

## Headers

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

## Request body

- object — The chat message body
  - `username` string, required — The user's VictorOps username.
  - `externalUsername` string, required — The username used in the integration application.
  - `text` string, required — The body of the chat message to be created.
  - `incidentId` number — When included, will link the created chat message to the provided incident's timeline.
  - `monitoringTool` string, required — The monitoring_tool value registered for your integration.
  - `tags` string[] — An optional list of tags to be added to the created chat message.

## Response `200`

A chat message was successfully created.

## 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` — User not found
- `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/versions/7a7391256058/schema)