---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: ZBS/quan-ly-template/template-api/api-upload-anh
title: API Upload Ảnh
---
# API Upload Ảnh

API upload ảnh template cho phép tải lên ảnh/logo trên hệ thống Zalo. Sau khi tải lên thành công, hệ thống sẽ trả về một media_id để có thể đính kèm khi tạo mẫu tin nhắn qua API tạo template (Chi tiết xem [tại đây](/docs/ZBS/quan-ly-template/template-api/api-tao-template)) và API chỉnh sửa template (Chi tiết xem [tại đây](/docs/ZBS/quan-ly-template/template-api/api-chinh-sua-template)).

:::warning Lưu ý
**Quyền cần có:** Quản lý Message Template
:::

## Prequisite

* Mã truy cập (Access Token) được doanh nghiệp (OA) ủy quyền cho App.
* Quyền cần có để sử dụng API: Quản lý tài sản.

## Giới hạn

* File upload định dạng JPG hoặc PNG, có dung lượng tối đa 500 KB.
* Hạn mức mỗi tháng: Tối đa 5000 ảnh được upload cho mỗi ứng dụng (App).

## Lưu ý:

* Quy định về Logo (Xem chi tiết):
  * Định dạng: PNG
  * Kích thước: 400x96 px
* Quy định về hình ảnh (Xem chi tiết):
  * Định dạng: JPG, PNG
  * Tỉ lệ: 16:9

## HTTP request

- **URL:** https://business.openapi.zalo.me/upload/image 
- **Method:** POST 
- **Content Type:** form-data/multipart
- **Response Type:** text/json

## Example request
```bash
curl --location 'https://business.openapi.zalo.me/upload/image' \
--header 'access_token: <access_token>' \
--form 'file=@"/path/to/file.png"'
```

### 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 | Đoạn mã cần truyền vào để xác minh quyền sử dụng API. Xem thêm [tài liệu tham khảo](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new). |


### Tham số body request

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| file | binary | Yes | - Nội dung nhị phân của file ảnh - Các định dạng ảnh hỗ trợ: jpg và png - Dung lượng tối đa: 500 KB |


## response
```json
{
	"data": {
		"media_id": "wESbL53O_shdvIPILC7iR_JpC552r_fjukKg"
	},
	"error": 0,
	"message": "Success"
}
```
### Cấu trúc thuộc tính data

| Thuộc tính | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| media_id | string | ID của ảnh được upload |