SMS API Documentation

FGGO Platform - Send SMS programmatically

Authentication

Include your API key in the request header:

X-API-Key: your-api-key

API keys are created in the admin dashboard under Security > API Keys

POST

Send SMS

/api/v1/messages 
{
  "to": {
    "channel": "sms",
    "id": "+2250748592131"
  },
  "from": "COOPEC",
  "body": "Your message here"
}
Field Required Description
to.channel Yes Always "sms"
to.id Yes Phone number (E.164 format)
from Yes Approved sender name
body Yes Message content (max 1600 chars) 
{
  "id": "msg_929d4413aa39",
  "status": "queued",
  "to": {
    "channel": "sms",
    "id": "+2250748592131"
  },
  "created_at": "2025-11-28T16:03:55.984771",
  "error_code": null,
  "error_message": null
}
curl -X POST "https://api-sms.fgentelecoms.com/api/v1/messages" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "to": {"channel": "sms", "id": "+2250748592131"},
    "from": "COOPEC",
    "body": "Hello!"
  }'

Try It

GET

Check Status

/api/v1/messages/{message_id} 
{
  "id": "msg_929d4413aa39",
  "status": "delivered",
  "to": {
    "channel": "sms",
    "id": "+2250748592131"
  },
  "created_at": "2025-11-28T16:03:55.984771",
  "error_code": null,
  "error_message": null
}
curl "https://api-sms.fgentelecoms.com/api/v1/messages/msg_929d4413aa39" \
  -H "X-API-Key: your-api-key"

Status Values

Status Description
queued Message created, waiting to be sent
sent Message sent to provider
delivered Message delivered to recipient
failed Delivery failed (check error_message)

Check Message Status