---
title: "Send an approved template to an audience; one credit per person"
method: POST
path: "/v1/broadcasts"
---

# Send an approved template to an audience; one credit per person

`POST /v1/broadcasts`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/broadcasts`
- Auth: HTTP bearer

## Request body

- object
  - `template` string, required
  - `language` string
  - `params` string[]
  - `audience` union, required
    - object
      - `kind` 'all', required
    - object
      - `kind` 'tag', required
      - `tag` string, required
    - object
      - `kind` 'service', required
      - `offering_id` string, uuid, required
    - object
      - `kind` 'contacts', required
      - `contact_ids` string[], required
    - object
      - `kind` 'bought', required
      - `days` integer, required
    - object
      - `kind` 'visited', required
      - `days` integer, required
    - object
      - `kind` 'lapsed', required
      - `days` integer, required
  - `consent` true, required

## Response `200`

Default Response

- object
  - `id` string, required
  - `total` number, required
  - `status` string, required

---

[API](https://skmtc.dev/octapi/apis/octapi-api.md) · [All operations](https://skmtc.dev/octapi/apis/octapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octapi/apis/octapi-api/revisions/580afda787d2?raw)