---
title: "Post a chat message on a job. Omit itemToMakeId and operationId to post on the job-level chat; supply both to post on one operation's chat. The message appears in the in-app job chat, and each mentioned user is subscribed to that chat."
method: POST
path: "/api/jobs/{jobId}/messages"
tags: ["Job Message"]
---

# Post a chat message on a job. Omit itemToMakeId and operationId to post on the job-level chat; supply both to post on one operation's chat. The message appears in the in-app job chat, and each mentioned user is subscribed to that chat.

`POST /api/jobs/{jobId}/messages`

## Path parameters

- `jobId` string, required

## Request body

- JobMessageCreateDto — A chat message to post on a job, or on one operation of an item-to-make on the job.
  - `body` string, required — Message text
  - `itemToMakeId` string, nullable — Id of the item-to-make to post on. Must be supplied together with operationId; omit both to post on the job itself.
  - `operationId` string, nullable — Id of the operation to post on. Must be supplied together with itemToMakeId; omit both to post on the job itself.
  - `mentions` string[], nullable — User Ids to @mention in the message. Please reference /api/users endpoints.

## Response `200`

Message posted

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input, itemToMakeId and operationId were not supplied together, or a mention is not a user
- `404` — Job did not exist, or the operation is not on that item-to-make of the job

## Changes

- **2026-09-11** `c00251431237` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/jobs/:jobId/messages/post.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/bae242bf0067?raw)