# 通过 User ID 发送推送

要向用户列表发送推送，您可以使用 [`/createMessage`](/zh/developer/api-reference/messages-api/#createmessage) API 调用，或者上传包含 User ID 的 CSV 文件。

## 通过 API 按 User ID 发送推送


### createMessage

<Aside type="tip">

请注意，[`/createMessage`](/zh/developer/api-reference/messages-api/#createmessage) 的参数是完全可定制的，因此您可以创建高度定制化的推送消息。

</Aside>


### 请求体参数

| 参数   | 描述                                                                                                      |
| ----------- | ---------------------------------------------------------------------------------------------------------------- |
| application | 您发送消息的目标 Pushwoosh application ID  |
| auth        | 来自 Pushwoosh Control Panel 的 API access token                                                                |
| send\_date  | 设置您希望发送消息的时间（UTC 格式），或使用 'now' 立即发送。                       |
| content     | 您的推送通知文本。                                                                             |
| users       | 您的推送消息将发送到的 User ID 列表。您一次最多可以向 1000 个 User ID 发送推送。                 |

### 请求示例

```
{
	"request": {
		"application": "APPLICATION_CODE",
		"auth": "API_ACCESS_TOKEN",
		"notifications": [{
			"send_date": "now",
			"content": "Hello world!",
			"users":["external_user_1"]
		}]
	}
}
```

### 响应示例

```
{
   "status_code":200,
   "status_message":"OK",
   "response": {
      "Messages":["{Notification code}"]
   } 
}
```