Skip to main content

Request Body

The request body defines the parameters required to send a single voice message via the IntelSend API.


Parameters

NameTypeRequiredSample ValueDescription
toString✅ Yes1323393337911-digit valid US number.
fromString✅ Yes1234567890Assigned 10-digit Caller ID.
liveMessageString✅ YesVoice messageMessage for live call detection. Text-to-speech is applied.
vmMessageString✅ YesVoice messageMessage for machine call detection. Text-to-speech is applied.
optOutMessageString❌ NoOpt-out messageOptional message played when the opt-out key is pressed.
sendAtDateTime❌ No2024-11-01 11:00:00UTC datetime format (YYYY-MM-DD HH:mm:ss). Default: current datetime.
uidString✅ Yesabc-123Unique identifier (max 40 characters) for tracking purposes.
programIdInteger✅ Yes123456-digit program ID for bundling requests for reporting and billing.
checkOptOutBoolean❌ NotrueDefault: true. If false, opt-out checks are bypassed.
maxRetryInteger❌ No1Default: 0. Number of retries if the voice message is not successfully delivered.
retryAfterInteger❌ No15Minutes to wait after each retry (range: 5-60).
repeatKeyInteger❌ No-13Default: -13 (#). Key press to repeat the message (0-9, -13 for #, -6 for *).
maxRepeatInteger❌ No2Default: 1. Number of times the message repeats when the repeat key is pressed.
optOutKeyInteger❌ No-13Default: -13 (#). Key press to opt out (0-9, -13 for #, -6 for *).

🔎 Example JSON Payload

{
"to": "13233933379",
"from": "1234567890",
"liveMessage": "Hi User, this is a live call message. Press pound to repeat.",
"vmMessage": "Hi User, this is a voicemail message.",
"optOutMessage": "Press # to opt out.",
"sendAt": "2024-11-01 11:00:00",
"uid": "abc-123",
"programId": 12345,
"checkOptOut": true,
"maxRetry": 1,
"retryAfter": 15,
"repeatKey": -13,
"maxRepeat": 2,
"optOutKey": -13
}

Pro Tip 💡

Always provide a unique uid for each request to avoid duplication and track each voice message effectively.

See Also

Refer to the Examples section for complete sample requests and responses.