> ## Documentation Index
> Fetch the complete documentation index at: https://developer.zeckta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Send your first SMS using the Zeckta Messaging API.

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.

<Info>
  All API requests must be authenticated using your API key.
</Info>

***

## Base URL

```text theme={null}
https://api.zeckta.com/v1
```

***

## Send Your First SMS

Use the endpoint below to queue a single SMS message.

```http theme={null}
POST /v1/messaging/sms/messages
```

### Example Request

```bash theme={null}
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

```json theme={null}
{
  "success": true,
  "message": "Message accepted for processing",
  "data": {
    "messageId": "f35f37e3-7db4-469d-a55e-17c9cbd1f681",
    "status": "queued"
  }
}
```

<Info>
  Messages are processed asynchronously. A successful response indicates the message has been accepted and queued for delivery.
</Info>

***

## Check Message Status

After submitting a message, use the returned message ID to retrieve its current delivery status.

```http theme={null}
GET /v1/messaging/sms/messages/{messageId}
```

### Example Request

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

### Example Response

```json theme={null}
{
  "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.

```http theme={null}
POST /v1/messaging/otp/request
```

See the OTP Verification section for complete examples and implementation guides.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" href="/authentication/authentication">
    Learn how API key authentication works.
  </Card>

  <Card title="SMS Messaging" href="/messaging/overview">
    Explore SMS messaging capabilities.
  </Card>

  <Card title="OTP Verification" href="/security-auth/otp-service-overview">
    Build secure authentication flows.
  </Card>

  <Card title="Delivery Statuses" href="/introduction/delivery-statuses">
    Understand the SMS delivery lifecycle.
  </Card>
</CardGroup>