create_voice_question is a tool in the Speak AI MCP server. Attach a question
template to a voice agent.
What does it do?
Attach a question template to a voice agent. Requires the OWNER or ADMIN role. agentId and templateId are both required and must belong to your company (or, for templateId, be a public system template): 404 if either isn’t found.
Parameters
create_voice_question takes 10 parameters, 2 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
agentId |
string | Yes | |
templateId |
string | Yes | From list_voice_question_templates. |
customConfig |
object | No | Agent-level override of the template’s defaultConfig; only the keys you send are overridden. |
required |
boolean | No | |
maxPromptAttempts |
number | No | |
noResponseBehavior |
enum: move_to_next_question, end_conversation | No | |
triggerCondition |
string | No | |
order |
number | No | |
enabled |
boolean | No | |
mappedFieldId |
string or null | No | ID of an existing company Field to write this question’s collected answer onto after each call. |
Behaviour
The Speak AI MCP server publishes these behaviour hints for create_voice_question.
- Can change data in your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call can have an extra effect.
- Stays inside Speak AI. Does not reach other systems.
Related
- Voice agents lists the rest of the Voice agents category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.