Docs API & Developer POST /api/v1/sms/send

POST /api/v1/sms/send

Send an SMS message to any number via the 6X SMS gateway.


POST /api/v1/sms/send

Send an SMS message to any phone number using your 6X wallet balance. Billed the same per-message rate as sending from the dashboard — the API Access add-on covers API access itself, not SMS usage.

Request body

FieldTypeRequiredDescription
tostringYesRecipient phone in international format e.g. +447911123456
fromstringYesSender ID shown to the recipient (max 11 characters, letters/numbers)
messagestringYesSMS message text (max 640 characters)

Example request

curl -X POST https://app.6xcom.com/api/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"+447911123456","from":"6XBusiness","message":"Your appointment is confirmed for 3pm."}'

Response

{
  "success": true,
  "result": {
    "success": true,
    "message_id": "abc123",
    "parts": 1,
    "amount": 0.03,
    "balance": 9.6531
  }
}

Error codes

StatusMeaning
402Insufficient wallet balance
422Validation error (missing to/from/message)
500SMS send failed
Was this article helpful?