Media

The Media directory holds your workspace's files: price lists, menus, brochures, product photos. Upload a file once, then send it as often as you like with "media": {"media_id": …} in a message or a reminder. It's the same directory as the Media directory page in the dashboard, so files uploaded there are listed here too.

Upload a file#

Send one file per request as multipart/form-data, in the field file. This is the one v2 endpoint that doesn't take JSON. The answer is 201 with the Media object.

• Up to 64 MB per file.
• Types: the type comes from the extension at the end of the file name, so keep it.

• Storage: all the workspace's files together can take up what its plan allows, from 250 MB to 10 GB (see Storage per plan). A file that doesn't fit is refused with storage_full.
• An image file (type image) is sent as an image by default; anything else as a file.
• Send an Idempotency-Key so a retry after a timeout doesn't store the file twice.

curl -X POST https://wbiztool.com/api/v2/media \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Idempotency-Key: price-list-2026-10" \
  -F "file=@./price list.pdf"

import os
import requests

with open("price list.pdf", "rb") as f:
    response = requests.post(
        "https://wbiztool.com/api/v2/media",
        headers={"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"},
        files={"file": ("price list.pdf", f, "application/pdf")},
        timeout=120,
    )
media = response.json()
print(response.status_code, media.get("id"), media.get("url"))

// Node.js 20+ (built-in fetch, FormData and fs.openAsBlob). Save as .mjs to use top-level await.
import { openAsBlob } from "node:fs";

const form = new FormData();
form.append("file", await openAsBlob("./price list.pdf"), "price list.pdf");

// Don't set Content-Type yourself; fetch adds the multipart boundary.
const response = await fetch("https://wbiztool.com/api/v2/media", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}` },
  body: form,
});
const media = await response.json();
console.log(response.status, media.id, media.url);

<?php
$ch = curl_init('https://wbiztool.com/api/v2/media');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY')],
    // An array body makes cURL send multipart/form-data.
    CURLOPT_POSTFIELDS     => ['file' => new CURLFile('/path/to/price list.pdf', 'application/pdf', 'price list.pdf')],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 120,
]);
$media = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $media['id'] . ' ' . $media['url'];

Answer (201):

{
  "id": 3301,
  "name": "price list.pdf",
  "type": "file",
  "mime_type": "application/pdf",
  "size": 182344,
  "url": "https://media.wbiztool.com/media/org_5012/media_5012_17608123450000_0.pdf",
  "created_at": "2026-10-18T10:31:40.120Z"
}

Then send it:

{
  "to": { "phone": "+919876543210" },
  "text": "Here is our new price list.",
  "media": { "media_id": 3301 }
}

The recipient sees the name it was uploaded with (price list.pdf); set media.file_name in the message to show another.

Errors when uploading#

List files#

The workspace's files, newest first, in pages (limit 1 to 100, default 25, and cursor).

curl "https://wbiztool.com/api/v2/media?limit=100" \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

The answer is {"data": [Media, …], "next_cursor": "…" or null}.

Get a file#

curl https://wbiztool.com/api/v2/media/3301 \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

A file that doesn't exist or was deleted answers 404 media_not_found.

Delete a file#

Deletes the file from the Media directory and from storage, so its url stops working. Messages already sent keep their copy on the recipient's phone.

It's refused while something will still send the file: a message that's waiting to go out (including a campaign's), an active reminder, or an active Google Sheets trigger. The answer is then 409 media_in_use, and count says how many. Cancel or change those first, or wait until the messages have gone out.

curl -X DELETE https://wbiztool.com/api/v2/media/3301 \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

{ "id": 3301, "deleted": true }

The Media object#

Related#

• Media directory in the dashboard
• Messages → Media: sending with media_id or a link
• Errors