Conventions and Case Sensitivity

Request conventions, canonical field names and enumerated value casing for the Outbound Voice Platform API.

Case sensitivity

All parameter names, JSON keys and enumerated values are case sensitive. Sending a field in the wrong case causes it to be ignored, and the request is rejected as missing a mandatory parameter or silently processed without the intended value.

Canonical field names

Send the form in the left column.

Canonical formAlso seen asWhere it appears
ukeyUkeyAll endpoints
fileFileBulk CSV upload form field
apiNameApi NameWebhook registration
botNamebotnameVoice Bot endpoints
countofNumberscountOfNumbersAll lead upload endpoints
secretKeyukeyLead Action query string only

Enumerated values

ParameterPermitted valuesConvention
retryTypeC, RUpper case, single character
ssmlGenderMALE, FEMALEUpper case
languageen-IN, hi-INLower case language, upper case region
action (keypress)PlayPrompt, RepeatPascal case
isDNDtrue, falseLower case
Header prefixesTXT_, NUM_, PLAY_Upper case, trailing underscore

Next: Lead Upload or CDR Reference.