Reference Data
Validate a list of call reasons
Check up to 10 candidate call_reasons strings against Telnyx's vetting heuristics before sending them on a DIR create or update. The endpoint flags strings that are likely to be rejected during vetting (too generic, banned phrases, length issues, etc.) so you can fix them up front.
post/call_reasons/validate
Request body
string[] required
Bare JSON array of candidate call-reason strings (NOT an object - there is no top-level call_reasons key on this endpoint). 1–10 strings, each ≤64 characters.
Example request
[ "Appointment reminders", "Billing inquiries" ]
Response
Per-string validation result.
Example response
{
"data": {
"non_approved_reasons": [
"Appointment reminders",
"Billing inquiries"
],
"requires_manual_vetting": true
}
}