Getting started

From account creation to your first queued SMS.

  1. Docs
  2. Getting started
  1. Create an organisation account

    Sign up at app.netnaunse.com, or call POST /v1/auth/register. Registration creates a user, organisation, and prepaid wallet.

  2. Authenticate

    Exchange credentials for a JWT with POST /v1/auth/login, or create an API key in the dashboard (Developers → API keys) / via POST /v1/auth/api-keys. Send either as Authorization: Bearer ….

  3. Ensure a Sender ID

    Pass senderId on each send, or configure an approved Sender ID for your organisation. Requests without a usable Sender ID return MISSING_SENDER_ID.

  4. Top up and send

    Your wallet is debited when a message is accepted (202). Insufficient balance returns 402 with INSUFFICIENT_BALANCE.

1. Login

POST /v1/auth/login
curl -X POST https://api.netnaunse.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@company.com",
    "password": "your-password"
  }'

2. Send an SMS

POST /v1/sms/send
curl -X POST https://api.netnaunse.com/v1/sms/send \
  -H "Authorization: Bearer YOUR_TOKEN_OR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "255712345678",
    "message": "Hello from Netnaunse",
    "senderId": "MyBrand"
  }'

A successful send returns 202 Accepted with a message id and status: "queued". See the SMS API guide for fields, listing, and status polling.

Next