# Send a single SMS (POST)

**POST /v1/messages/sms**

Uses Basic auth (clientid:clientsecret) and requires X-Wallet header containing the wallet token. Request is asynchronous; final status is delivered to CallbackUrl if provided.



## Servers
- Production: https://api.sierrahive.com (Production)


## Authentication methods
- Basic auth


## Parameters
### Headers
- **X-Wallet** (string)
  Wallet token header (e.g., "Token 333")



### Body: application/json (object)

- **From** (string)
  Sender name (not more than 11 characters)
- **To** (string)
  Destination MSISDN in full E164 format without '+'
- **Content** (string)
  Message content
- **Reference** (string)
  Client reference (optional but recommended)
- **CallbackUrl** (string(uri))
  Callback URL (optional but recommended; must be valid)


## Responses
### 200
Accepted for processing (initial status)

#### Body: application/json (object)
- **Cost** (number(float))
  Initial cost (may be 0.0 at submission time)
- **Destination** (string)

- **Id** (string(uuid))
  ID from AppHive
- **Ticket** (string(uuid))
  Same as Id
- **ClientReference** (string | null)
  Your reference (if provided)
- **Status** (string)
  Initial transaction status

### 400
Bad request

### 401
Unauthorized


[Powered by Bump.sh](https://bump.sh)