---
title: "Mídia · Documentação da API Zaiped"
description: "Para enviar um arquivo, suba antes: POST /media?numberId=... com os bytes crus no corpo e o Content-Type do arquivo. A resposta traz um mediaId, que você passa como media: { path } na mensagem. Um upload serve a todo número da conta."
lang: "pt-BR"
canonical: "https://zaiped.com/developers/docs/media"
alternate: "https://zaiped.com/en/developers/docs/media"
---

# Mídia

Para enviar um arquivo, suba antes: POST /media?numberId=... com os bytes crus no corpo e o Content-Type do arquivo. A resposta traz um mediaId, que você passa como media: { path } na mensagem. Um upload serve a todo número da conta.

```
curl -X POST "https://zaiped.com/v1/media?numberId=YOUR_NUMBER_ID" \
  -H "Authorization: Bearer zp_..." \
  -H "Content-Type: image/jpeg" \
  --data-binary @foto.jpg
```

Mídia recebida chega com o evento message.received: o evento traz o messageId, e GET /media/{messageId} devolve uma URL assinada válida por uma hora. Se a Meta ainda não entregou os bytes, a rota responde 404 com media_unavailable; retente em alguns segundos.