Web3 SMS

Web3 SMS

API documentation

Numbers, verification emails, wallet, and SMS-Activate compatibility reference.

Download OpenAPI 3.1

Authentication

REST requests use a Bearer API key. Order creation also requires an Idempotency-Key header.

Authorization: Bearer w3sms_live_...
Idempotency-Key: your-unique-request-id

REST v1

GET/api/v1/balance
GET/api/v1/offers
GET/api/v1/emails/domains
POST/api/v1/emails
POST/api/v1/emails/batch
GET/api/v1/emails/{id}
DELETE/api/v1/emails/{id}
POST/api/v1/emails/{id}/reorder
POST/api/v1/activations
GET/api/v1/activations/{id}
POST/api/v1/activations/{id}/cancel
POST/api/v1/rentals
GET/api/v1/rentals/{id}/messages
POST/api/v1/payments
GET/api/v1/webhook-endpoints

SMS-Activate

GET /stubs/handler_api.php?api_key=...&action=getBalance

Supported actions include catalog, activation, reactivation, prolongation, rental, status, history, finish, and cancel operations.

Webhook signing

Verify HMAC-SHA256 over timestamp + "." + raw request body, then deduplicate by event ID.

v1 = HMAC_SHA256(secret, timestamp + "." + raw_body)