---
title: "Shares new messages on Hireloop with Users, Hiring Teams or Everyone and sends emails."
method: POST
path: "/messages/shares"
tags: ["messages"]
---

# Shares new messages on Hireloop with Users, Hiring Teams or Everyone and sends emails.

`POST /messages/shares`

How does it work:
* In **content** field, provide a text to be shared.
* @-mention users to send them an email
  * In **content** field use **@[USER:id]** to mention a User, e.g. @[USER:324132421]
* Email responses are added as comments to your update
* \#-tag candidates to link updates to their profiles
  * In **content** field use **#[CANDIDATE:id]** to tag a candidate, e.g. #[CANDIDATE:9847954623]
* Use **shareWith** to share a feed update with individuals, hiring teams or everyone
  * In **users** field, provide an array of User IDs with which you want to share, e.g. "users": ["12343542356","12343542357"].
  * In **hiringTeamOf** field, provide an array of Job IDs, this will share message with a full hiring team of those jobs, e.g. "hiringTeamOf": ["123423432322","123423432324"].
  * **everyone** flag allows sharing with everyone in a company. If not provided, defaults to **false**.
  * **openNote** flag allows sharing with everyone in a company that has access to the candidate. If not provided, defaults to **false**

## Request body

- Message
  - `content` string, required — Content of the message
  - `correlationId` string — CorrelationId is an optional parameter for you to add an additional ID reference to the note. This will simply be appended onto the note and will not be tracked/managed/process by SmartRecruiters in any way.
  - `shareWith` ShareWith — Sharing and message visibility options
    - `users` string[] — List of users to share the message with
    - `hiringTeamOf` string[] — List of jobs to share the message with its hiring teams
    - `everyone` boolean — Set the message to be visible to everyone in a company
    - `openNote` boolean — Set the message to be visible to everyone in a company who has access to #-tagged candidate

## Response `201`

- MessageDetails
  - `id` string
  - `shareRequired` boolean

## Other responses

- `400` — with codes: * **INVALID_VISIBILITY_OPTIONS** when specifying openNote and everyone flag set to true in the same time, * **JOB_NOT_FOUND** when sharing with hiring team of jobs that do not exist, * **NO_ACCESS_TO_CANDIDATE** when tagging candidate you do not have access to, * **MENTIONED_USERS_NOT_FOUND** when mentioning users that do not exist, * **SHARED_WITH_USERS_NOT_FOUND** when sharing with users that do not exist, * **TOO_MANY_RECIPIENTS**, when more than 100 message recipients in total (mentioned directly or being a part of mentioned hiring teams)

---

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