Skip to main content
This guide walks you end-to-end: create an account, grab a key, send a message, see it arrive.
1

Create an account

Sign up at app.robase.dev with Google or email. Your first team + project are created automatically and you land on the dashboard.
2

Grab a test API key

In the dashboard, open API keys and click Create key. Tick the test mode checkbox — test keys (rb_test_*) route to a simulator that doesn’t cost anything and returns realistic delivery reports.
Copy the key now. We show the full token exactly once; after that you only see the prefix.
3

Install the SDK

npm install @robase/node
Prefer cURL? Skip this step — every example below has a cURL variant.
4

Send your first SMS

Use a magic test number so you get a realistic delivery receipt back:You’ll get back an id, status: "queued", and the cost (0 for test keys). Within ~100 ms the message moves to delivered and fires the sms.delivered webhook if you’ve registered one.
5

Check delivery in the dashboard

Open the SMS tab in the project. The message appears in the live log with a green delivered pill. Click it for the full timeline: queued → sent → delivered.
6

Graduate to live mode

When you’re ready to send to real numbers:
  1. Create a live key (leave the test checkbox unticked).
  2. Register a sender ID (e.g. SHUTTLERS) from the SMS page. NCC requires a registered entity + use case for Nigeria.
  3. Top up your wallet via Billing → Add credit (Paystack / Flutterwave).
  4. Switch your code to use the rb_live_* key.
That’s it. Everything else — idempotency, retries, webhooks — keeps working the same way.

SMS sending

Full send API reference with templates, batching, scheduling.

Webhooks

Get notified the instant a message delivers or fails.

Error handling

Every error code, what it means, and how to fix it.

Test mode

Magic numbers for every delivery scenario — delivered, failed, slow, DND.