---
title: "Send a direct message to multiple Slack users with optional templating."
method: POST
path: "/messageMultipleUsers"
tags: ["message", "user", "template"]
---

# Send a direct message to multiple Slack users with optional templating.

`POST /messageMultipleUsers`

Sends direct messages to multiple Slack users. Supports both simple text messages and templated messages with dynamic content for each user.

## Request body

- object
  - `body` object — Body of the messageUsers sls call
    - `arguments` object, required
      - `userIds` string[], required — The IDs of the users to send the message to. User IDs start with 'U'.
      - `text` string, required — The text of the message to be sent. Can include template variables: {mention} (mentions user), {user_name} (user's name), {user_email} (email), {user_title} (job title), {user_phone} (phone), {user_status} (status), {user_avatar} (profile image), {first_name} (first name), {last_name} (last name). Template variables are automatically replaced with user data.
      - `username` string — Optional custom username for the message.
      - `icon_url` string — Optional URL to an image to use as the icon for the message.

## Response `200`

Successful response

- object[]
  - `ok` boolean, required — true if the request was successful.
  - `channel` string, required — The ID of the channel where the message was posted.
  - `ts` string, required — The timestamp of the message.
  - `message` object, required — An object containing the details of the sent message.
    - `type` string — The type of message.
    - `subtype` string — The subtype of the message.
    - `text` string — The text of the message.
    - `ts` string — The timestamp of the message.
    - `bot_id` string — The ID of the bot that sent the message.
    - `username` string — The username of the bot that sent the message.
    - `attachments` unknown[] — An array of attachments.
      - unknown

## Other responses

- `400` — Bad Request - The request was invalid or cannot be served.
- `500` — Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.net/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.net/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/versions/cd0edf0c2cdf/schema)
