# Telmian — full reference > SMS API for apps built with AI. Ask Claude, Cursor or Lovable to add OTP codes, reminders and two-way SMS. €0.05 per SMS in Europe, no phone or SIM needed. ## Phone verification by SMS Check that a phone number is real at sign-up or login, without building the hard parts. - **Login codes (OTP)**: Telmian creates a 6-digit code, sends it and checks it. It works for 10 minutes and tries are limited. - **Verify by text**: The other way round: the user taps a link and texts you from their own phone. No code to type. - **Supabase phone sign-in**: Plug Telmian into the Supabase Auth SMS hook and phone login works. ## SMS for bookings, orders and alerts Write a message once as a template, then send it with each customer’s details. - **Templates with fields**: Write "Hi {name}, your order {order} has shipped" once. Each send fills in the fields. Every template is checked when you save it. - **Scheduled sending**: Pick a time and Telmian sends it then. Change or cancel it until it leaves. - **Appointment reminders**: At a fixed time or 24 hours before, once or every day, week or month. - **Alerts to your phone**: A text to your own number for a new order or a site that is down, from your app or a secret link any tool can call. ## Two-way SMS with your customers Customers can answer your messages, and your app knows what they said. - **Replies marked yes or no**: Ask "Reply YES to confirm". Each reply sits next to its message, marked yes, no or other. - **Answer within 24 hours**: Reply with one of your approved messages, from the panel or through the API, within 24 hours of the customer's last text. ## An SMS API made for your coding assistant Everything Claude, Cursor or Codex needs to set it up right the first time. - **The Telmian MCP server**: Your assistant sends tests, checks deliveries and reads replies for you. - **Simple API and Node.js library**: Readable errors and a live OpenAPI description your assistant can read. - **Never sends twice**: If a request is retried, the message still goes out only once. - **Your app is told what happens**: Signed webhooks for delivered, failed and customer replies. - **Free sandbox**: Simulated deliveries and replies, so you build and test without real SMS or credit. ## Account, keys and billing Clear numbers and safe defaults. - **Pay per SMS**: €0.05 per SMS in Europe, prepaid. Delivery reports, replies and the sending number included. - **Projects and keys**: One project per app. Each key gets only the permissions it needs, and an end date. - **Usage and exports**: See your spending as it happens. Export messages and usage as CSV or XML. - **Privacy by default**: Phone numbers are masked in logs and exports. Message text is encrypted and deleted after 30 days. ## FAQ ### What is Telmian? Telmian is an SMS API for apps you build with AI. Your assistant connects through the Telmian MCP server and sets up login codes, reminders, notifications or two-way replies. You send to mobile numbers in Europe at €0.05 per SMS. ### How do I add SMS to my app with AI? Add the Telmian MCP server to Claude Code, Cursor, Codex or Windsurf, approve it in the browser, then ask for what you need. Your assistant creates a sandbox key, saves it in .env and sends a test you can see in the panel. ### What is the easiest way to add phone verification (OTP)? Two calls: start a verification with the phone number, then check the code the user typed. Telmian creates, sends, expires and rate-limits the code. ### Does Telmian work with Supabase? Yes. Telmian plugs into the Supabase Auth SMS hook, so Supabase phone sign-in sends its codes through Telmian. ### Can customers reply to my messages? Yes. Replies are linked to the message they answer and marked yes, no or other. Your app is told automatically, and you see them in the panel. ### How do I send an SMS from a Next.js app? Install the telmian package, put your API key in .env and call sendMessage from a route handler or server action. Never from the browser: the key stays on the server. ### Can I send free text? Messages to customers use templates with fields (name, date, order number). You write them, they are checked when saved, before use. Free text is for alerts to your own verified numbers. ### Can I send from my business name instead of a number? No. Telmian sends from phone numbers. Your approved business name goes at the start of the text, so people know who is writing. ### How much does an SMS cost? €0.05 + VAT per SMS to a mobile number in Europe, prepaid from €5 (EU businesses with a VAT number: reverse charge). Delivery reports, replies and the sending number are included. One SMS is 160 characters, or 70 with emoji. ### Which countries can I send SMS to? Mobile numbers in Europe, at the same €0.05 per SMS. For a specific country, write to info@telmian.com. ### Can I test without sending real SMS? Yes. Sandbox projects simulate deliveries and replies, so you build the whole flow without credit and without real SMS. ### Is Telmian an alternative to Twilio? Telmian covers the SMS use cases most apps need (verification, notifications, reminders and replies) with a much smaller surface, so an AI assistant can set it up in one go.