Send an SMS message

Sends an SMS. Czech and Slovak numbers only (+420 / +421). Price is 1.36 CZK per segment - longer messages (or ones with characters outside the GSM-7 alphabet, typically Czech diacritics) split into more segments, each billed separately - see segments in the response. Requires a first credit top-up - the welcome credit does not unlock SMS. To send from your own SMS number, set fromNumber (a number from GET /v1/sms-numbers). The recipient then sees your number instead of SMSinfo. Sending from the number works only to Czech numbers (+420), costs 1.90 CZK per segment (excluding VAT) and has a daily cap per account: 20 messages in the first 30 days after you buy the number, 50 after that. The from field in the request is still ignored.

post/v1/messages

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/messages
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional key for one logical request. Its scope is global to this API key, independent of the HTTP method, path, or body: use a new value for every distinct logical action across all endpoints and request bodies, and reuse it only to retry the exact same logical request. Reusing a non-blank key within 24 hours returns the stored response; a concurrent request with the same key returns 409 idempotency_in_progress. A missing or whitespace-only value disables idempotency.

Request body

tostring required

SMS destination with Czech +420 or Slovak +421 country code, normalized to E.164. Sending from an SMS number (fromNumber) accepts only +420.

bodystring required

Message text. Under the shared sender, include your name or brand in the text. Billed per GSM-7 or Unicode segment. Carrier acceptance is not a delivery receipt.

fromNumberstring

Optional active SMS number of your account in E.164, from GET /v1/sms-numbers, to send from instead of the shared sender SMSinfo. Billed per segment at the SMS number rate. Omit it, or send an empty string, to use the shared sender.

Response

Sent message

idstring required
status'pending' | 'sent' | 'failed' | 'unknown' required
priceHalnumber required
segmentsnumber

Changes

No recorded changes to this operation across all 1 revision of this API.