Quickstart

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.

Introduction

Authentication

Messaging

OTP Service

Workspace

Errors

FAQs

Prerequisites

Base URL

Send Your First SMS

Example Request

Example Response

Check Message Status

Example Request

Example Response

Request an OTP

Next Steps

Authentication

SMS Messaging

OTP Verification

Delivery Statuses

​Prerequisites

​Base URL

​Send Your First SMS

​Example Request

​Example Response

​Check Message Status

​Example Request

​Example Response

​Request an OTP

​Next Steps

Authentication

SMS Messaging

OTP Verification

Delivery Statuses

Prerequisites

Base URL

Send Your First SMS

Example Request

Example Response

Check Message Status

Example Request

Example Response

Request an OTP

Next Steps