> ## Documentation Index
> Fetch the complete documentation index at: https://help.eazybe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subir un archivo multimedia

> Subir un archivo multimedia. Consulta los parámetros, el ejemplo y las respuestas disponibles para esta operación.



## OpenAPI

````yaml es/api-reference/meta/openapi.json POST /meta/phone-numbers/{phoneNumberId}/media
openapi: 3.1.0
info:
  title: API Wrapper de Meta de Eazybe
  version: 1.0.0
  description: >-
    Una superficie REST autenticada de Eazybe para la API de WhatsApp Business
    Cloud.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: >-
      Sustituye este marcador por el host de la API de Eazybe asignado a tu
      entorno.
security:
  - bearerAuth: []
tags:
  - name: Números de teléfono
    description: Descubre las WABA y los identificadores de números de teléfono conectados.
  - name: Mensajería
    description: Envía mensajes de WhatsApp y actualiza su estado.
  - name: Plantillas
    description: Administra las plantillas de mensajes de WhatsApp.
  - name: Archivos multimedia
    description: Sube, consulta y elimina archivos multimedia de WhatsApp.
  - name: Webhooks
    description: Administra las suscripciones de webhooks de una WABA.
  - name: Analíticas
    description: Consulta analíticas de mensajería, conversaciones, precios y plantillas.
  - name: Perfiles y configuración
    description: Administra perfiles empresariales y ajustes de números de teléfono.
  - name: Automatización
    description: Configura mensajes de bienvenida, preguntas iniciales y comandos.
  - name: Códigos QR
    description: Administra códigos QR de clic para chatear.
  - name: Flows
    description: Administra el ciclo de vida de WhatsApp Flows.
  - name: Administración de números
    description: Registra números, administra PIN y sincroniza datos de coexistencia.
  - name: Lista de bloqueados
    description: Consulta, bloquea y desbloquea usuarios de WhatsApp.
paths:
  /meta/phone-numbers/{phoneNumberId}/media:
    post:
      tags:
        - Archivos multimedia
      summary: Subir un archivo multimedia
      description: >-
        Subir un archivo multimedia. Consulta los parámetros, el ejemplo y las
        respuestas disponibles para esta operación.
      operationId: uploadMedia
      parameters:
        - $ref: '#/components/parameters/PhoneNumberId'
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
              required:
                - file
              description: >-
                ```bash

                curl -X POST
                "https://cerberus.eazybe.com/meta/phone-numbers/5647382910/media"
                \
                  -H "Authorization: Bearer <jwt>" \
                  -F "file=@invoice.pdf"
                ```
      responses:
        '200':
          description: >-
            Media uploaded


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `404` | `phoneNumberId` not linked to your organization | Verify
            the id |

            | `400` | Unsupported MIME type or file over WhatsApp's size limit
            (image 5 MB, document 100 MB, video/audio 16 MB) | Re-encode or
            compress |

            | `500` | No `file` field in the multipart body | Send as
            `multipart/form-data` with field `file` |

            | `502` | Graph unreachable or timed out | Retry with backoff |
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
              example:
                id: '1234567890123456'
components:
  parameters:
    PhoneNumberId:
      name: phoneNumberId
      in: path
      required: true
      description: ID del número de teléfono devuelto por `GET /meta/phone-numbers`.
      schema:
        type: string
      example: '5647382910'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: >-
        Token bearer de Eazybe. El token identifica la organización y debe
        mantenerse en el servidor.

````