---
title: "Tạo chiến dịch"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/campaigns.create
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Tạo chiến dịch

Tạo chiến dịch nháp (tìm khách hoặc nuôi), tuỳ chọn từ một mẫu và kèm người.

Tạo chiến dịch nháp (tìm khách hoặc nuôi), tuỳ chọn từ một mẫu và kèm người.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `campaigns.create` |
| Scope cần | `campaigns.write` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Trả kết quả ngay |
| Cần `Idempotency-Key` | Có |
| Vai trò thành viên được phép | `owner`, `manager` |
| Trong app | Chiến dịch → Tạo |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `name` | `chữ` | Có |   |
| `goal` | `"outreach" \| "nurture"` | Có |   |
| `template` | `"soft_open" \| "after_purchase" \| "invite_channel"` | Không |   |
| `personIds` | `uuid[]` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/campaigns.create \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"name":"…","goal":"outreach"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `id` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "id": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Dùng qua MCP

Tool `campaigns_create` có tên sẵn trong profile: Thiết lập tự chạy (`setup`). Ở profile khác, tìm bằng `tools_search` rồi chạy bằng `tools_run`.