API Documentation

Integrate SMS capabilities into your applications with our powerful API

Quick Start Guide

Get started with our SMS API in minutes

Authentication

All API requests require authentication using your API token

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json

API Endpoints

Send SMS

POST https://cloudsms.gr/api/v3/sms/send

Send Campaign

POST https://cloudsms.gr/api/v3/sms/campaign

Send Your First SMS

Single Number

curl -X POST https://cloudsms.gr/api/v3/sms/send \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "recipient": "31612345678",
    "sender_id": "YourName",
    "type": "plain",
    "message": "This is a test message"
}'

Multiple Numbers

curl -X POST https://cloudsms.gr/api/v3/sms/send \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "recipient": "31612345678,880172145789",
    "sender_id": "YourName",
    "type": "plain",
    "message": "This is a test message",
    "schedule_time": "2024-03-20 07:00"
}'

Required Parameters

Parameter	Required	Type	Description
recipient	Yes	string	Phone number(s) to send message. Use comma for multiple numbers.
sender_id	Yes	string	Your sender ID (max 11 characters)
type	Yes	string	Message type (use "plain" for text messages)
message	Yes	string	The content of your SMS message

Success Response

{
    "status": "success",
    "data": "sms reports with all details"
}

Error Response

{
    "status": "error",
    "message": "A human-readable description of the error."
}

SDK Libraries

Use our official SDKs to integrate quickly in your preferred language

PHP SDK: composer require gsoftware/cloudsms-php
Python SDK: pip install cloudsms
Node.js SDK: npm i cloudsms-gsoftware

Ready to Integrate?

Get API Access

View Full Documentation