Skip to main content
Send Broadcast Message
curl --request POST \
  --url https://integration.getmateo.com/api/v1/send_broadcast \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "attachment": "<string>",
  "from": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "require_marketing_opt_in": true,
  "to_recipients": [
    {
      "contact_id": "<string>",
      "full_name": "<string>",
      "handle": "<string>",
      "placeholder_values": [
        "<string>"
      ]
    }
  ],
  "to_segments": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "send_after": "2023-11-07T05:31:56Z",
  "placeholder_values": [
    "<string>"
  ],
  "marketing_channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "review_channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "sendout_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
from
string<uuid>
required

The channel the broadcast is sent from

template_id
string<uuid>
required

The template to use for the broadcast

attachment
string | null

Attachment URL. Can either https:// or media_library://

require_marketing_opt_in
boolean
default:true

Whether the recipients must have opted in to marketing messages

to_recipients
object[] | null

The list of recipients to send the broadcast to

to_segments
string<uuid>[] | null

The list of segments to send the broadcast to

send_after
string<date-time> | null

The time to send the broadcast after

placeholder_values
string[] | null

Placeholder values

marketing_channel_id
string<uuid> | null

Marketing Channel ID

review_channel_id
string<uuid> | null

Review Channel ID

Response

The broadcast was sent successfully

sendout_id
string<uuid>
required

The ID of the sendout that has been sent

I