---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/tin-nhan/quan-ly-tin-nhan/upload-anh-gif
title: Upload ảnh GIF
---
# Upload ảnh GIF

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

:::warning Lưu ý
Ảnh GIF 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 muốn xem lại GIF sau thời gian trên, người dùng sẽ được thông báo ảnh GIF không còn tồn tại. Quota cho API là không giới hạn.

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/gif 
- **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.gif" \
https://openapi.zalo.me/v2.0/oa/upload/gif
```

### 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 file nhị phân của file hình GIF. Dung lượng tối đa 5MB. |


## Example respond

```json
{
  "data": {
    "attachment_id": "hDtMfuo7iDncIQ1aSOQp9FHOROFisDP7m64BxCKe"
  },
  "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 | ID của ảnh được upload, sử dụng cho API [gửi thông báo đính kèm ảnh](/docs/OA/tin-nhan/tin-tu-van/gui-tin-tu-van-dinh-kem-anh). |