How do I create an API key?

Confirm your email, then open the account menu, choose “API Keys” and create a key. With it, your own code can buy numbers, rent numbers and read SMS, as the API documentation explains.

Updated November 18, 2026

The SMSZ API lets a script or a server do what you do in the order form: buy one-time numbers, rent numbers and read the SMS they receive. The key tells SMSZ that the requests come from your account. Numbers bought through the API are paid from your balance, so top it up first.

Before you start

API keys need a confirmed email. If the account menu shows “Verify now”, press it, open the email we send and click the link. Check your spam folder if it does not come. More in create and verify your account.

Create the key

  1. Sign in, open the account menu and choose “API Keys”.
  2. Give the key a name you will recognise, for example the name of the server it runs on.
  3. Choose the permissions the key needs, such as buying activations or ordering rentals. Give it only what your code uses.
  4. Press “Create key”.
  5. Copy the key at once and store it in a safe place. It is shown only one time. If you lose it, create a new key.

Webhooks and AI agents

The same window has a “Webhooks” tab. Add your server’s address there, and SMSZ sends each incoming SMS to it, so your code does not have to keep asking for new messages. To let an AI assistant use SMSZ, connect it through the MCP server. It works with Claude, Cursor or any MCP client.

Keep the key secret

  • Treat the key like a password. Keep it on your server, not in a public repository or in code that runs in a browser.
  • Do not send the key to anyone, support included.
  • If a key leaks, press “Revoke” next to it under API Keys and create a new one. Anything that used the old key stops working at once.

Every request and response is described in the API documentation (in English). Start there once your key is ready.

Still stuck? Write to us

Email [email protected] or use the contact page. We usually reply within 24 hours. To get it solved in one reply, include: