Skip to main content
This guide walks you through sending your first SMS using the Zeckta Messaging API.

​
Prerequisites

Before you begin, ensure you have:
  • A Zeckta account
  • An active workspace
  • A valid API key
You can generate API keys from the Zeckta Dashboard.
All API requests must be authenticated using your API key.

​
Base URL

https://api.zeckta.com/v1

​
Send Your First SMS

Use the endpoint below to queue a single SMS message. 
POST /v1/messaging/sms/messages

​
Example Request

curl -X POST "https://api.zeckta.com/v1/messaging/sms/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dest": "+233240000000",
    "src": "ZECKTA",
    "message": "Hello from Zeckta!"
  }'

​
Example Response

{
  "success": true,
  "message": "Message accepted for processing",
  "data": {
    "messageId": "f35f37e3-7db4-469d-a55e-17c9cbd1f681",
    "status": "queued"
  }
}
Messages are processed asynchronously. A successful response indicates the message has been accepted and queued for delivery.

​
Check Message Status

After submitting a message, use the returned message ID to retrieve its current delivery status. 
GET /v1/messaging/sms/messages/{messageId}

​
Example Request

curl -X GET \
"https://api.zeckta.com/v1/messaging/sms/messages/f35f37e3-7db4-469d-a55e-17c9cbd1f681" \
-H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "success": true,
  "message": "Message retrieved successfully",
  "data": {
    "messageId": "f35f37e3-7db4-469d-a55e-17c9cbd1f681",
    "status": "delivered"
  }
}

​
Request an OTP

Zeckta also provides a built-in OTP verification service for authentication workflows. 
POST /v1/messaging/otp/request
See the OTP Verification section for complete examples and implementation guides.

​
Next Steps

Authentication

Learn how API key authentication works.

SMS Messaging

Explore SMS messaging capabilities.

OTP Verification

Build secure authentication flows.

Delivery Statuses

Understand the SMS delivery lifecycle.