POST https://skyden.kiloconnectrdc.com/api/v1/messages

Send Media (Image / Document)

Send an image or a document to a WhatsApp number. The media can be provided either as a public URL or uploaded first via /media.

API key required application/json

Body Parameters

to Required

string (E.164)

Recipient phone number, without + or spaces.

Example: 243812345678

type Required

enum (image | document)

Use image for photos, document for PDFs and other files.

content Required

object

Media payload.

media_url Optional

string (URL)

Public URL of the file.

media_id Optional

string (UUID)

Use a previously uploaded media.

caption Optional

string (max 1024)

Optional caption.

filename Required

string

Required for documents.

Code Examples

curl -X POST https://skyden.kiloconnectrdc.com/api/v1/messages \
  -H 'Authorization: Bearer sks_live_xxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "to": "243812345678",
    "type": "image",
    "content": {
      "media_url": "https://example.com/photo.png",
      "caption": "Regarde !"
    }
  }'

<?php
use Skyden\Send\SkydenSend;

SkydenSend::config('sks_live_xxxxx');

SkydenSend::to('+243812345678')
    ->image('https://example.com/photo.png', 'Regarde !');

import { SkydenSend } from 'skyden-send';

SkydenSend.config('sks_live_xxxxx');

await SkydenSend
    .to('+243812345678')
    .image('https://example.com/photo.png', 'Regarde !');

Success Response

202 Accepted

{
  "success": true,
  "data": {
    "id": "01a094...",
    "status": "queued",
    "type": "image"
  }
}

Error Responses

422 INVALID_MEDIA_URL

The URL is unreachable or not a supported file type.

413 MEDIA_TOO_LARGE

The file exceeds the maximum size for your plan.