Iletimerkezi MCP Server vs SwapWallet

S

send_sms

Send an SMS to one or many Turkish or international mobile numbers in a single request. Returns an orderId used for delivery reports (get_report) and scheduled-order cancellation (cancel_order). Destructive and irreversible: dispatches a real SMS, deducts paid credit, and cannot be recalled once the message enters the carrier queue. For pre-approval testing use sender "APITEST"; this forces iys="0" and replaces the message text with a fixed verification string. Once a real sender is approved on the account, "APITEST" returns code 450. Auth: API key + hash. The panel toggle "Allow API access" (Settings > Security > Access Permissions) must be ON or every call returns 401. IP allowlist applies when configured. Conditional fields: order.sender must be a panel-approved alphanumeric header, max 11 chars. order.iys is required and chooses the regulatory channel. Use "0" for transactional messages (OTP, password reset, order/delivery/payment notification, appointment reminder, regulatory notice); these are out of scope of commercial-message consent under Turkish Law No. 6563 and IYS rules. Use "1" for commercial messages (campaign, promotion, discount, marketing); with iys="1", order.iysList is also required and must be "BIREYSEL" (individuals) or "TACIR" (businesses). KVKK personal-data obligations remain separate and always apply. Field naming caveat: the recipient container is order.message.receipents (sic.); this is a backward-compatibility typo and "recipients" returns error 452. Rate limits: 100 SMS per second per account for transactional sends, counted by recipient count rather than request count, so one request to five numbers consumes five SMS units. Bulk sends accept up to 50,000 recipients per request; chunk larger lists client-side at 50,000. Scheduling: order.sendDateTime ("dd/MM/yyyy HH:mm", Turkey local time, no seconds) schedules a future dispatch. Cancel before the message leaves the queue via cancel_order with the returned orderId. Reference: https://www.iletimerkezi.com/en/docs/api/send-sms