---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/tin-nhan/quan-ly-tin-nhan/upload-file
title: Upload file
---
# Upload file

:::tip
Bạn có thể sử dụng API upload file để phục vụ việc [gửi thông báo đính kèm file.](/docs/OA/tin-nhan/tin-tu-van/gui-tin-tu-van-dinh-kem-file) 
::: 

:::warning Lưu ý
 File sau khi được upload và gửi đến người dùng sẽ được lưu trên server tối đa 7 ngày. Trường hợp người dùng xem lại file sau khoảng thời gian trên sẽ được thông báo file không còn tồn tại. 

Quota cho API là:
+ 5000 request/ tháng.

**Quyền cần có:** Quyền gửi tin và thông báo qua OA
:::

## HTTP request

- **URL:** https://openapi.zalo.me/v2.0/oa/upload/file 
- **Method:** POST 
- **Content Type:** multipart/form-data 
- **Response Type:** text/json  

## Example request

```bash
curl \
-H 'access_token: <your_access_token>' \
-F "file=@/home/test.docx" \
https://openapi.zalo.me/v2.0/oa/upload/file
```

### Tham số header


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| [access_token](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) | string | yes | Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token [tại đây](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new). |


### Cấu trúc body của request

| Column 1 | Column 2 | Column 3 | Column 4 |
| --- | --- | --- | --- |
| Tham số | Loại | Tính bắt buộc | Mô tả |
| file | binary | yes | Nội dung nhị phân của file Lưu ý: Chỉ hỗ trợ file PDF/DOC/DOCX/CSV, dung lượng file không vượt quá 5MB |


## Example respond
```json
{
  "data": {
    "token": "hDtMfuo7XKzhraJb6jm53AiDncIQ1aSOQp9FHOROFisDP7m64BxCKe"
  },
  "error": 0,
  "message": "Success"
}
```

### Cấu trúc thuộc tính data

| Thuộc tính | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| token | string | Token của file, sử dụng cho API gửi thông báo đính kèm file. |