---
title: "Send Broadcast Message"
method: POST
path: "/send_broadcast"
tags: ["Send Broadcast"]
---

# Send Broadcast Message

`POST /send_broadcast`

Send a Broadcast message to a list of recipients and / or segments

## Request body

- object
  - `attachment` string, nullable — Attachment URL. Can either https:// or media_library://
  - `from` string, uuid, required — The channel the broadcast is sent from
  - `template_id` string, uuid, required — The template to use for the broadcast
  - `require_marketing_opt_in` boolean — Whether the recipients must have opted in to marketing messages
  - `to_recipients` object[], nullable — The list of recipients to send the broadcast to
    - `contact_id` string, nullable
    - `full_name` string, nullable
    - `handle` string, nullable
    - `placeholder_values` string[], nullable
    - `contact_external_id` string, nullable
    - `contact_secondary_external_id` string, nullable
  - `to_segments` string[], nullable — The list of segments to send the broadcast to
  - `send_after` string, date-time, nullable — The time to send the broadcast after
  - `placeholder_values` string[], nullable — Placeholder values
  - `marketing_channel_id` string, uuid, nullable — Marketing Channel ID
  - `review_channel_id` string, uuid, nullable — Review Channel ID

## Response `200`

The broadcast was sent successfully

## Other responses

- `400` — Invalid input

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)