---
title: "Create Voice Question"
description: "Attach a question template to a voice agent."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Voice Question

`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](/mcp/tools/voice-agents/) lists the rest of the Voice agents
  category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/voice-agents/create_voice_question/index.mdx