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

Send Text Message

Dispatches a new outbound WhatsApp text message through an active connection. The message is queued and processed asynchronously — you receive an immediate message ID.

API key required application/json

Body Parameters

to Required

string (E.164)

Recipient phone number in international format, without + or spaces.

Example: 243812345678

whatsapp_connection_id Optional

string (UUID)

Specific WhatsApp connection to use. If omitted, the first active connection of the project is used.

type Required

enum (text)

Message type. Use text for plain text messages.

content Required

object

Message content wrapper.

text Required

string (max 4096 chars)

The message text. Supports WhatsApp markdown.

Example: Bonjour 👋

Code Examples

curl -X POST https://skyden.kiloconnectrdc.com/api/v1/messages \
  -H 'Authorization: Bearer sks_live_xxxxx' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: msg-001' \
  -d '{
    "to": "243812345678",
    "type": "text",
    "content": { "text": "Bonjour 👋" }
  }'

<?php
use Skyden\Send\SkydenSend;

SkydenSend::config('sks_live_xxxxx');

SkydenSend::to('+243812345678')->send('Bonjour 👋');

import { SkydenSend } from 'skyden-send';

SkydenSend.config('sks_live_xxxxx');

await SkydenSend.to('+243812345678').send('Bonjour 👋');

Success Response

202 Accepted

{
  "success": true,
  "data": {
    "id": "01a094e3-0ccc-721f-a578-1dd114f1b59d",
    "status": "queued",
    "to": "243812345678",
    "type": "text",
    "created_at": "2026-09-13T10:30:00Z"
  },
  "request_id": "req_xxxxx"
}

Error Responses

422 INVALID_PHONE

The phone number is not in a valid E.164 format.

402 INSUFFICIENT_BALANCE

Your wallet balance is too low to send this message.

422 CONNECTION_INACTIVE

No active WhatsApp connection available for this project.