---
title: "Soạn bài mới (trạng thái nháp)"
method: POST
path: "/ir/{symbol}/oa/posts"
tags: ["IROfficialAccount"]
---

# Soạn bài mới (trạng thái nháp)

`POST /ir/{symbol}/oa/posts`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/ir/{symbol}/oa/posts`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-write`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/ir/:symbol/oa/posts/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `symbol` string, required

## Request body

- FireAntApiModelsIRIROaPostChangeRequest: Soạn hoặc sửa bài Official Account
  - `title` string: Tiêu đề
  - `content` string, required: Nội dung
  - `mediaJson` string: Ảnh và tệp đính kèm
  - `symbolsJson` string: Mã chứng khoán gắn kèm
  - `templateId` integer: Mẫu công bố đã dùng
  - `scheduledDate` string, date-time: Thời điểm hẹn đăng
  - `pushOnPublish` boolean: Gửi thông báo đẩy khi đăng (trừ hạn mức chiến dịch)
  - `pushTitle` string: Tiêu đề thông báo đẩy

## Response `200`

OK

- FireAntApiModelsIRIROaPostItem: Bài viết của Official Account
  - `oaPostId` integer: ID bài trong hệ thống IR
  - `companyId` integer: ID công ty
  - `symbol` string: Mã chứng khoán
  - `postId` integer: ID bài trên mạng xã hội sau khi đăng
  - `title` string: Tiêu đề
  - `content` string: Nội dung
  - `mediaJson` string: Ảnh và tệp đính kèm
  - `symbolsJson` string: Mã chứng khoán gắn kèm
  - `templateId` integer: Mẫu công bố đã dùng
  - `templateName` string: Tên mẫu
  - `status` 0 | 1 | 2 | 3 | 4 | 5 | 6: Trạng thái trong quy trình duyệt (0 = Draft, 1 = PendingApproval, 2 = Approved, 3 = Scheduled, 4 = Published, 5 = Rejected, 6 = Failed)
  - `scheduledDate` string, date-time: Thời điểm hẹn đăng
  - `publishedDate` string, date-time: Thời điểm đã đăng
  - `pushOnPublish` boolean: Gửi thông báo đẩy khi đăng
  - `pushTitle` string: Tiêu đề thông báo đẩy
  - `createdBy` string: Người soạn
  - `createdDate` string, date-time: Ngày soạn
  - `modifiedBy` string: Người sửa gần nhất
  - `modifiedDate` string, date-time: Thời điểm sửa gần nhất
  - `submittedBy` string: Người trình duyệt
  - `submittedDate` string, date-time: Thời điểm trình duyệt
  - `approvedBy` string: Người duyệt
  - `approvedDate` string, date-time: Thời điểm duyệt
  - `rejectedBy` string: Người từ chối
  - `rejectedDate` string, date-time: Thời điểm từ chối
  - `rejectReason` string: Lý do từ chối
  - `hangfireJobId` string: Mã công việc nền đã hẹn giờ
  - `lastError` string: Lỗi gần nhất khi đăng
  - `likes` integer: Lượt thích
  - `replies` integer: Lượt trả lời
  - `shares` integer: Lượt chia sẻ
  - `engagementScore` number, double: Điểm tương tác
  - `metrics` FireAntApiModelsIRIROaPostMetricPoint[]: Hiệu quả theo ngày
    - `date` string, date-time: Ngày
    - `likes` integer: Lượt thích
    - `replies` integer: Lượt trả lời
    - `shares` integer: Lượt chia sẻ
    - `engagementScore` number, double: Điểm tương tác

## Changes

- **2026-09-25** `a481789cd81c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/ir/:symbol/oa/posts/post.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)