---
title: "Send SMS, MMS or WhatsApp to subscribers of a group"
method: POST
path: "/orgunit/{orgunitId}/messages"
tags: ["Send"]
---

# Send SMS, MMS or WhatsApp to subscribers of a group

`POST /orgunit/{orgunitId}/messages`

Dispatches a one-time message broadcast, test message, unicast message, or 
    two-way interactive chat message to subscribers within one or more groups. 
    Supports multi-channel delivery including SMS, MMS (requires pre-uploading 
    media files to attach a valid 'mediaPath'), and WhatsApp (requires an approved 
    WhatsApp template layout).
    
- 1 SMS = 1 Message Credits
- 1 MMS = 3 Message Credits
- 1 WhatsApp = Region based charges from wallet

## Path parameters

- `orgunitId` string, required

## Request body

- InteractionBroadcastMessageRequest
  - `groupId` string[] — An array of unique groupIds targeting the subscriber lists that will receive this message.
  - `from` string — The sending entity identifier or group name displayed to the recipient in the message's start.
  - `message` string — The raw text payload to be delivered to subscribers. Leave empty or omit if you are utilizing a pre-configured template layout via 'templateId'.
  - `templateId` string — The unique identifier of a message template. When passed, the system will deliver the structured template message layout. For sending WHATSAPP broadcast, this field is mandatory.
  - `subscriberMobileNo` string[], nullable — An array of specific destination mobile phone numbers. Used to isolate delivery to individual subscribers instead of the entire group list. Mandatory for messageType Test, Twoway and Unicast
  - `messageType` 'Test' | 'BroadcastMessage' | 'Twoway' | 'Unicast' — Defines the operational intent of the transmission. Valid values are: 'Test' (internal verification), 'BroadcastMessage' (mass campaign), 'Twoway' (one-to-one interactive chat), or 'Unicast' (targeted multi-number delivery).
  - `referenceId` string, nullable — An optional external tracking or transaction identifier used to correlate this transmission with your internal database records.
  - `autoSubscribe` boolean — When set to true, automatically opts in and subscribes any phone numbers provided in 'subscriberMobileNo' to the targeted group if they are not already members.
  - `mediaDetails` MediaDetails
    - `mediaPath` MediaPath[], nullable
      - `fileName` string
      - `extension` string
      - `fileSaveId` string
      - `mimetype` string
      - `url` string
  - `channelType` 'SMS' | 'MMS' | 'WHATSAPP' — Specifies the target communication network channel for delivery. Accepted values include SMS, MMS, or WHATSAPP.
  - `fallbackMessage` FallbackMessage
    - `from` string, nullable
    - `message` string
    - `channelType` string

## Response `202`

Success

- MessageResponseExternalApiResponseNew
  - `data` MessageResponse
    - `transactionId` string, nullable
  - `appCode` string, nullable
  - `message` string, nullable
  - `isError` boolean

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/ministrybytext/apis/pbt-api-documentation.md) · [All operations](https://skmtc.net/ministrybytext/apis/pbt-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ministrybytext/pbt-api-documentation/versions/ca6e9c8f430d/schema)