---
title: "📄 Send File"
method: POST
path: "/send-message/file"
---

# 📄 Send File

`POST /send-message/file`

The Send File Message API endpoint allows you to send files with an optional caption to a WhatsApp account via the API. This endpoint supports various file types, making it easy to share documents, images, and other media with your users.

## Request body

- object
  - `contact_id` string, required — The contact id
  - `caption` string, required
  - `file` object, required
    - `mimeType` string, required — The mime type file
    - `filename` string, required — The filename of the file
    - `url` string, required — The url of the file

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `id` string
    - `status` string
    - `message` object
      - `caption` string
      - `file` string
      - `details` object
        - `mimetype` string
        - `mediaKey` string
        - `fileSha256` string
        - `timestamp` string
    - `timestamp` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/crunchz/apis/live-2.md) · [All operations](https://skmtc.net/crunchz/apis/live-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchz/live-2/versions/14e6b45e8808/schema)