API: keys and your first request

The API lets you send SMS directly from your own system — a website, CRM or app. Full documentation with examples in nine languages: api.usms.uz.

Where to get a key

Profile → Profile tab → Integration access block.

• The test key is available immediately, without account approval. Sending with it costs nothing and doesn’t reach the operator — handy for checking your integration.
• The live key is issued after account approval: Generate key.

A key is a pair of a login and a secret. You can view the secret again with the Show button. When you reissue a key, the old one stops working immediately.

How to authenticate

Send this header with every request:

Authorization: Bearer LOGIN:SECRET

This is not your account password — only the pair from the Integration access block.

Main methods

Base URL: https://usms.uz/api/v1

• GET /balance — balance;
• GET /templates — your templates;
• POST /send — a single message;
• POST /send-batch — a batch of messages;
• GET /status/{id} — message status;
• POST /quote — cost calculation before sending;
• GET /messages — list of sent messages;
• POST /templates/request — request a new template;
• POST /webhook — the address for status notifications.

Never share your secret key — not in chats and not in support tickets. If the key gets into the wrong hands, reissue it immediately.