---
title: "Update broadcast SMS"
method: PUT
path: "/broadcasts/{broadcast_id}"
tags: ["SMS Broadcast"]
---

# Update broadcast SMS

`PUT /broadcasts/{broadcast_id}`

Update broadcast SMS details. Provide either contact_ids or contact_list_ids, but not both.

## Path parameters

- `broadcast_id` integer, required

## Request body

- UpdateBroadcastData
  - `tracking_number` string, required — Phone number the caller dialed (the tracking/DNI number). Convirza routes calls from this number through the configured call flow. String of digits.
  - `agent_ring_to` string, required — Phone number of the agent receiving SMS replies. String. Must resolve to 10 digits; formatting like parentheses, dashes, or '+1' prefix is accepted.
  - `message` string, required — SMS message body. String. Max length set by carrier (typically 160 chars for single-segment, up to 1600 for concatenated).
  - `contact_ids` integer[] — List of contact IDs. Use this or contact_list_ids (not both). Type: array of integer.
  - `contact_list_ids` integer[] — List of contact list IDs. Use this or contact_ids (not both). Type: array of integer.
  - `schedule_datetime` string — When to send the broadcast, required when is_scheduled=true. Format 'YYYY-MM-DD HH:mm:ss'.
  - `ouid` integer — Org unit ID (group ID) for the broadcast. Type: integer.
  - `is_scheduled` boolean — Boolean. If true, the broadcast is queued for future delivery; if false, it sends immediately. Default false.

## Response `200`

Broadcast updated successfully

- PostResponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string, required — Error message when result='error'. String. Empty/null on success.
  - `data` string — Response payload. Shape varies by endpoint.

## Other responses

- `default` — Unexpected error

---

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