Send images, video, audio and documents
Every message type is a JSON POST to its own path under /v1/messages. All of them need deviceId and to.
Endpoints and bodies
| Type | Path | Extra fields |
|---|---|---|
| Text | /v1/messages/chat | body |
| Image | /v1/messages/image | image, caption |
| Video | /v1/messages/video | video, caption |
| Audio | /v1/messages/audio | audio |
| Document | /v1/messages/document | document, filename |
| Link | /v1/messages/link | link |
| Contact | /v1/messages/contact | contact |
| Location | /v1/messages/location | address, lat, lng |
Example: an image with a caption
import os
import requests
response = requests.post(
"https://quackapi.com/v1/messages/image",
headers={"x-api-key": os.environ["QUACKAPI_KEY"]},
json={
"deviceId": 1,
"to": "923001234567",
"image": "https://example.com/photo.jpg",
"caption": "Your order",
},
timeout=15,
)
response.raise_for_status()
print(response.json()) # {'success': True, 'messageId': 123, 'status': 'queued'}Incoming media
Media you receive is delivered to your webhook as text such as [Image] followed by the caption, not as a file.
Related
Last reviewed 2026-11-09. QuackAPI is an unofficial linked-device service. Acceptable use