curl --request POST 'https://api.brightalk.ai/sms' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header 'Brightalk-Version: 2026-07-16' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: webinar-example-001' \
--data '{"phone_number":"TAIWAN_MOBILE_E164","message":"Webinar reminder","test_mode":true}'const response = await fetch("https://api.brightalk.ai/sms", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16",
"Content-Type": "application/json",
"Idempotency-Key": "webinar-example-001"
},
body: JSON.stringify({
"phone_number": "TAIWAN_MOBILE_E164",
"message": "Webinar reminder",
"test_mode": true
})
});
const result = await response.json();
console.log(result);import os
import requests
response = requests.post(
"https://api.brightalk.ai/sms",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
"Content-Type": "application/json",
"Idempotency-Key": "webinar-example-001"
},
json={"phone_number":"TAIWAN_MOBILE_E164","message":"Webinar reminder","test_mode":True}
)
print(response.json()){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"phone_number": "<string>",
"message": "<string>",
"segments": 3,
"credits_reserved": 1,
"credits_deducted": 1,
"metadata": {},
"reference_id": "<string>",
"external_id": "<string>",
"test_mode": true,
"error_code": "<string>",
"created_at": "<string>",
"expires_at": "<string>"
}Schedule an SMS message
Schedule a single-recipient SMS, with multipart support. Each segment costs 1 credit. Count the final text including the carrier title, [sender] prefix, resolved variables and final short URL. Chinese, full-width symbols, line breaks, underscores or backticks use UCS-2: 70 characters for one part, then 66 per part, up to 6 parts (396 characters). Thus 71–132 UCS-2 characters cost 2 credits and 133–198 cost 3. GSM text allows 160 units for one part, then 152 per part, up to 6 parts (912 units). GSM ^ [ ] ~ | \ each consume 2 units, with escape pairs kept together; other GSM characters consume 1. Emoji/non-BMP characters are unsupported. Manual one-to-one sends and MCP brightalk_send_sms instead have a single-part limit of 70 UTF-16 code units or 159 ASCII bytes.
curl --request POST 'https://api.brightalk.ai/sms' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header 'Brightalk-Version: 2026-07-16' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: webinar-example-001' \
--data '{"phone_number":"TAIWAN_MOBILE_E164","message":"Webinar reminder","test_mode":true}'const response = await fetch("https://api.brightalk.ai/sms", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16",
"Content-Type": "application/json",
"Idempotency-Key": "webinar-example-001"
},
body: JSON.stringify({
"phone_number": "TAIWAN_MOBILE_E164",
"message": "Webinar reminder",
"test_mode": true
})
});
const result = await response.json();
console.log(result);import os
import requests
response = requests.post(
"https://api.brightalk.ai/sms",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
"Content-Type": "application/json",
"Idempotency-Key": "webinar-example-001"
},
json={"phone_number":"TAIWAN_MOBILE_E164","message":"Webinar reminder","test_mode":True}
)
print(response.json()){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "scheduled",
"phone_number": "<string>",
"message": "<string>",
"segments": 3,
"credits_reserved": 1,
"credits_deducted": 1,
"metadata": {},
"reference_id": "<string>",
"external_id": "<string>",
"test_mode": true,
"error_code": "<string>",
"created_at": "<string>",
"expires_at": "<string>"
}Authorizations
Headers
Body
Response
Successful response.