# POST /api/v1/voice_agent_flows

Create a new AI Flow with the provided attributes.

## Params

| Param name                         | Description<br> <br>**Validations** |
|------------------------------------|-------------------------------------|
| **voice_agent_id**<br>Optional     | Voice Agent – ID of the AI Agent that owns this Flow.<br>**Validations:**<br>- Must be a valid foreign key reference to an [Voice Agent](/content/api/docs/1.0/voice_agents/index.html). Refer to: [/api/docs/1.0/voice_agents](/content/api/docs/1.0/voice_agents/index.html) |
| **execution_mode**<br>Optional     | Execution Mode – Defines how the Flow executes. ‘agent’ runs an AI-driven interview. ‘action’ performs an immediate call-routing or end-call action without further AI interaction.<br>**Validations:**<br>- Must be one of: `agent`, `action`. |
| **action_type**<br>Optional        | Action Type – Specifies the routing action when execution_mode is ‘action’. For example: redirect, forward_to_buyer, block_caller, end_call.<br>**Validations:**<br>- Must be one of: `redirect`, `forward`, `block_caller`, `end_call`. |
| **prompt**<br>Optional              | Prompt – System instructions or context specific to this Flow. Can include rules, validation criteria, or conversation style guidance.<br>**Validations:**<br>- Must be a String |
| **greeting**<br>OptionalBlank Value Allowed | Greeting – Optional opening line spoken to the caller at the start of this Flow before any questions are asked.<br>**Validations:**<br>- Must be a String |
| **description**<br>OptionalBlank Value Allowed | Description – Short summary describing the purpose of this Flow.<br>**Validations:**<br>- Must be a String |
| **conversation_timeout**<br>OptionalBlank Value Allowed | Conversation Timeout – Per-prompt timeout (in seconds) before the Flow fails if no response is received. Overrides the AI Agent’s default if set.<br>**Validations:**<br>- Must be a decimal number. |
| **contact_field_ids**<br>OptionalBlank Value Allowed | Translation missing: en.api.voice_agent_flows.contact_field_ids<br>**Validations:**<br>- Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an [Contact Field](/content/api/docs/1.0/contact_fields/index.html). Refer to: [/api/docs/1.0/contact_fields](/content/api/docs/1.0/contact_fields/index.html) |
| **forward_to_offer_id**<br>OptionalBlank Value Allowed | Forward To Offer – ID of the offer to forward the call to if action_type is ‘redirect’.<br>**Validations:**<br>- Must be a valid foreign key reference to an [Offer](/content/api/docs/1.0/offers/index.html). Refer to: [/api/docs/1.0/offers](/content/api/docs/1.0/offers/index.html) |
| **forward_to_buyer_id**<br>OptionalBlank Value Allowed | Forward To Buyer – ID of the buyer or destination DID to forward to if action_type is ‘forward_to_buyer’.<br>**Validations:**<br>- Must be a valid foreign key reference to an [Buyer](/content/api/docs/1.0/buyers/index.html). Refer to: [/api/docs/1.0/buyers](/content/api/docs/1.0/buyers/index.html) |