# Getting started with the VeloBotix SMS API

> Create a VeloBotix account, get an API key, and send your first SMS in Sri Lanka with SEND_SINGLE.

Source: https://www.velobotix.app/docs/getting-started

Docs

# Getting started

## What VeloBotix is

VeloBotix is a Sri Lankan SMS gateway and SMS API platform that enables businesses and developers to send transactional, OTP, bulk and application-generated SMS messages.

This documentation covers the public customer REST API at the portal base URL. You call one endpoint and select the action with the FUN query parameter.

## Prerequisites

Create an account at the VeloBotix portal and copy your API key from the account settings.

Register or use an approved Sender ID for your account.

Have a Sri Lanka mobile number in local format 07XXXXXXXX for test sends.

## Base URL

All requests go to https://portal.velobotix.app/api.php. Append ?FUN=… to choose the action.

```
https://portal.velobotix.app/api.php
```

## Send your first SMS

Authenticate with HTTP Basic Auth (email as username, API key as password), then POST JSON with senderID, to, and msg.

```
curl -X POST \
  "https://portal.velobotix.app/api.php?FUN=SEND_SINGLE" \
  -u "YOUR_EMAIL:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID": "VeloBotix",
    "to":       "0701234567",
    "msg":      "Your OTP is 483920. Valid for 5 minutes."
  }'
```

## Next steps

Read authentication options (Basic Auth or GET with un/up), then explore single send, bulk, balance, and language examples.

## FAQ

Do I need an SDK?

No. The API is plain HTTP. Use curl, fetch, or any HTTP client.

Where do I get an API key?

Sign in at https://portal.velobotix.app and copy the key from your account.

## Create account

Sign up in the portal and get your API key — username is your email, password is the key.

[Open portal — get API key](https://portal.velobotix.app)