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

# Xerobi SMS Gateway API Introduction

> Xerobi SMS Gateway API - A modern, developer-friendly SMS Gateway API

> **Note**: This API supports transactional, OTP, promotional and bulk messaging with comprehensive delivery tracking.

## Overview

The Xerobi SMS Gateway API provides a comprehensive set of endpoints for sending SMS messages, managing sender IDs, creating message templates, and tracking delivery reports. The API supports multiple message types including OTP, transactional, and promotional messaging.

## Authentication

All requests require Bearer token authentication:

```
Authorization: Bearer sk_live_xxxxx
```

## Base URL

Production: `https://api.hixbe.com/sms`

## Versioning

API versioning is handled via the `Xerobi-Version` header. Use `2026-01-01` for the latest version.

Include this header in all API requests:

```
Xerobi-Version: 2026-01-01
```

## Key Features

### Message Types

* **OTP**: One-time passwords and verification codes
* **Transactional**: Order confirmations, alerts, and notifications
* **Promotional**: Marketing and promotional messages

### Bulk Messaging

Send messages to multiple recipients using CSV uploads or recipient lists.

### Sender ID Management

Register and manage custom sender IDs for branded messaging.

### Message Templates

Create reusable templates with variable substitution for consistent messaging.

### Delivery Tracking

Real-time delivery reports and webhook notifications.

### Balance Management

Check account balance and usage statistics.

## Rate Limits

* Single SMS: 100 requests per minute
* Bulk SMS: 10 bulk jobs per hour
* Account endpoints: 60 requests per hour

## Message Length

* Standard SMS: 160 characters (GSM-7) or 70 characters (UCS-2)
* Concatenated SMS: Up to 1530 characters (GSM-7) or 670 characters (UCS-2)

## Getting Started

> [card] [Quickstart Guide](https://docs.xerobi.com/faq-guides/quickstart.md)
>
> Get started with your first SMS integration

> [card] [SMS API FAQ](https://docs.xerobi.com/faq-guides/sms-api-faq.md)
>
> Common questions and detailed guides

> [card] [Authentication](https://docs.xerobi.com/faq-guides/authentication.md)
>
> Learn about API keys and security

> [card] [Webhooks](https://docs.xerobi.com/faq-guides/webhooks.md)
>
> Set up SMS delivery notifications


## Related topics

- [Xerobi Payment API Introduction](https://docs.xerobi.com/payment-api/introduction.md)
- [Xerobi Certification & Badge API Introduction](https://docs.xerobi.com/certify/introduction.md)
- [SMS API FAQ](https://docs.xerobi.com/faq-guides/sms-api-faq.md)
- [Xerobi Developer Documentation](https://docs.xerobi.com/index.md)
- [Changelog](https://docs.xerobi.com/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.