> ## 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.

# SMS Messaging

> Send transactional and bulk SMS messages using the Zeckta Messaging API.

The Zeckta Messaging API enables developers and businesses to send transactional SMS messages, bulk campaigns, and OTP notifications at scale.

Messages are processed asynchronously and include delivery tracking, reporting, and real-time webhook notifications.

***

## Key Capabilities

<CardGroup cols={2}>
  <Card title="Single SMS" icon="message">
    Send individual transactional messages with delivery tracking.
  </Card>

  <Card title="SMS Campaigns" icon="megaphone">
    Deliver bulk messages to large recipient audiences.
  </Card>

  <Card title="Sender Names" icon="font">
    Register and manage branded sender identities.
  </Card>

  <Card title="Webhooks" icon="link">
    Receive real-time delivery notifications.
  </Card>
</CardGroup>

***

## Message Types

| Type         | Character Limit   | Encoding          | Best For                         |
| ------------ | ----------------- | ----------------- | -------------------------------- |
| Plain Text   | 160               | GSM 03.38         | Standard notifications           |
| Unicode      | 70                | UCS-2             | Non-English languages and emojis |
| Concatenated | Multiple segments | GSM 03.38 / UCS-2 | Longer messages                  |

<Info>
  Long messages are automatically segmented and reassembled on supported devices.
</Info>

***

## Core Endpoints

### Send Single SMS

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

Queue an individual SMS message for delivery.

### Get Message Status

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

Retrieve the latest delivery status of a message.

### Create Campaign

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

Create and queue a bulk SMS campaign.

### Get Campaign Report

```http theme={null}
GET /v1/messaging/sms/campaigns/{uuid}
```

Retrieve campaign delivery analytics and reporting.

***

## Message Lifecycle

Every message progresses through a delivery lifecycle.

```text theme={null}
queued
  ↓
processing
  ↓
submitted
  ↓
sent
  ↓
delivered
```

Messages may also transition into terminal states such as:

```text theme={null}
failed
expired
undeliverable
rejected
```

See the Delivery Statuses guide for a complete reference.

***

## Message Preview

Before sending a message, you can calculate:

* Message segments
* Character count
* Encoding type
* Billing units

Using:

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

***

## Workspace Isolation

Messages are isolated at the workspace level.

A workspace can only:

* Send messages using its own API keys
* View its own messages
* Access its own campaigns
* Retrieve its own reports
* Use its own Sender Names

Cross-workspace access is not permitted.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Send Single SMS" href="/messaging/send-single-sms">
    Learn how to send individual SMS messages.
  </Card>

  <Card title="SMS Campaigns" href="/messaging/create-campaign">
    Learn how to send bulk campaigns.
  </Card>

  <Card title="Sender Names" href="/messaging/sender-names">
    Register and manage sender identities.
  </Card>

  <Card title="Webhooks" href="/messaging/webhooks">
    Receive real-time delivery updates.
  </Card>
</CardGroup>