---
id: "en/api-post-nd-api-enterprise-broadcast"
title: "Make an announcement"
language: "en"
description: "POST /nd/api/enterprise/broadcast: Publish announcement interface description, including path, method, parameters and return information."
canonical_url: "https://www.babel.cc/public/babelwiki/en/api-post-nd-api-enterprise-broadcast.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-enterprise-broadcast.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-enterprise-broadcast.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-enterprise-broadcast.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# Make an announcement

| Properties | Values |
| --- | --- |
| HTTP method | `POST` |
| Interface path | `/nd/api/enterprise/broadcast` |
| Category | Enterprise API |

## Interface description

Interface path: `/nd/api/enterprise/broadcast`


#### POST request body parameters

| Parameter | Type | Description (source requirements, defaults and scope) |
| --- | --- | --- |
| `title` | `string` | Announcement content string (required) |
| `content` | `string` | content (required) |
| `target_users` | `string[]` | JSON array of recipient user IDs. Pass `[]` when no users are specified directly. |
| `target_deps` | `string[]` | JSON array of target department IDs. Recipients include members of these departments and their subdepartments. Pass `[]` when no departments are specified. |

When both `target_users` and `target_deps` are empty arrays, no announcement is sent. When at least one array is nonempty, the specified users and users in the target departments are combined before sending. Supply both JSON arrays explicitly. Parameter names do not contain `[]`; do not serialize an entire array into a string.

Both arrays empty: no announcement is sent.

```json
{
  "title": "Example announcement",
  "content": "Example content",
  "target_users": [],
  "target_deps": []
}
```

Send to the combined audience of specified users and department members (example IDs):

```json
{
  "title": "Example announcement",
  "content": "Example content",
  "target_users": ["2001"],
  "target_deps": ["3001"]
}
```

#### Return field description

```json
{"code":0,"success":true}
```

## Call instructions

- Before calling, you need to complete [Get token](https://www.babel.cc/public/babelwiki/en/api-post-api-token-do.html) or the corresponding login-free authentication, and carry `Authorization: Bearer <access_token>` in the request header.
- If there are differences in parameters and return fields due to deployment versions, the actual private cloud API documents and joint debugging results should prevail.
- Category: Enterprise API.

## Confirm Recipient Scope

An empty array does not mean everyone. If only `target_users` is nonempty, send to those users. If only `target_deps` is nonempty, send to members of those departments and their subdepartments. If both are nonempty, combine the audiences. If both are empty, do not send. These rules describe explicitly supplied arrays; they do not assume that omitting a parameter is equivalent to passing an empty array.