Create agent (template-driven)
Create agent (template-driven)
Creates a new agent for the campaign using server-managed voice and agent-type templates. Unlike `POST /agent/{campaignId}`, this endpoint resolves voice settings and scripts from template IDs rather than requiring inline configuration.
Two fields are required:
- `agentTypeId` — ID of the agent-type template (defines scripts and conversational behavior).
- `VoiceId` — ID of the voice template (defines TTS provider, language, and voice settings).
### Available `VoiceId` values
Pick the `ID` column value for the voice you want.
#### English (US)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `uYXf8XasLslADfZ2MB4u` | Nicole | female | 11labs | [listen](https://cdn.aqx.ai/voices/nicole-en.mp3) |
| `POgnTczcLAPhQxgBI5JL` | Emma | female | 11labs | [listen](https://cdn.aqx.ai/voices/emma.mp3) |
| `Crm8VULvkVs5ZBDa1Ixm` | Andrea | female | 11labs | [listen](https://cdn.aqx.ai/voices/Andrea-mono.wav) |
| `GGRMgbKfr7QscdcrvWga` | Sadie | female | 11labs | [listen](https://cdn.aqx.ai/voices/Sadie_en.mp3) |
| `kdmDKE6EkgrWrrykO9Qt` | Olivia | female | 11labs | [listen](https://cdn.aqx.ai/voices/Olivia_en.mp3) |
| `AzY2BqTy0uxbEAbMtXEG` | Ava | female | 11labs | [listen](https://cdn.aqx.ai/voices/ava-original.mp3) |
| `A4ZrKx5iK0qHfhGvknY6` | Kelcey | female | 11labs | [listen](https://cdn.aqx.ai/voices/Kelcey-mono.wav) |
| `RPEIZnKMqlQiZyZd1Dae` | Christopher | male | 11labs | [listen](https://cdn.aqx.ai/voices/Christopher-mono.wav) |
| `kdVjFjOXaqExaDvXZECX` | Burt | male | 11labs | [listen](https://cdn.aqx.ai/voices/Burt-mono.wav) |
| `JZ3e95uoTACVf6tXaaEi` | Johnny | male | 11labs | [listen](https://cdn.aqx.ai/voices/Johnny-mono.wav) |
| `aTxZrSrp47xsP6Ot4Kgd` | Tiana | female | 11labs | [listen](https://cdn.aqx.ai/voices/tiana-en.mp3) |
| `OOk3INdXVLRmSaQoAX9D` | Tiffany | female | 11labs | [listen](https://cdn.aqx.ai/voices/tiffany-en.mp3) |
| `56AoDkrOh6qfVPDXZ7Pt` | Sienna | female | 11labs | [listen](https://cdn.aqx.ai/voices/Sienna-en.mp3) |
| `XcXEQzuLXRU9RcfWzEJt` | Maya | female | 11labs | [listen](https://cdn.aqx.ai/voices/Maya-en.mp3) |
| `kdnRe2koJdOK4Ovxn2DI` | Freya | female | 11labs | [listen](https://cdn.aqx.ai/voices/Freya-en.mp3) |
| `l4Coq6695JDX9xtLqXDE` | Iris | female | 11labs | [listen](https://cdn.aqx.ai/voices/Iris-en.mp3) |
| `j45mXgB0BR0mIJbdyK09` | Jade | female | 11labs | [listen](https://cdn.aqx.ai/voices/Jade-en.mp3) |
| `P7x743VjyZEOihNNygQ9` | Charlene | female | 11labs | [listen](https://cdn.aqx.ai/voices/charlene-en.mp3) |
| `77aEIu0qStu8Jwv1EdhX` | Joseph | male | 11labs | [listen](https://cdn.aqx.ai/voices/joseph-en.mp3) |
| `ewxUvnyvvOehYjKjUVKC` | Andre | male | 11labs | [listen](https://cdn.aqx.ai/voices/andre-en.mp3) |
| `Z7HhYXzYeRsQk3RnXqiG` | Samuel | male | 11labs | [listen](https://cdn.aqx.ai/voices/samuel-en.mp3) |
| `UgBBYS2sOqTuMpoF3BR0` | Tyler | male | 11labs | [listen](https://cdn.aqx.ai/voices/tyler-en.mp3) |
| `dMyQqiVXTU80dDl2eNK8` | Hannah | female | 11labs | [listen](https://cdn.aqx.ai/voices/hanna-en.mp3) |
| `asteria` | Brooke | female | deepgram | [listen](https://cdn.aqx.ai/voices/brooke-en.mp3) |
| `8d8ce8c9-44a4-46c4-b10f-9a927b99a853` | Jules | female | cartesia | [listen](https://cdn.aqx.ai/voices/jules-en.mp3) |
| `a38e4e85-e815-43ab-acf1-907c4688dd6c` | Claire | female | cartesia | [listen](https://cdn.aqx.ai/voices/claire-en.mp3) |
#### English (UK)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `ZF6FPAbjXT4488VcRRnw` | Charlotte | female | 11labs | [listen](https://cdn.aqx.ai/voices/charlotte-uk.mp3) |
| `19STyYD15bswVz51nqLf` | Gemma | female | 11labs | [listen](https://cdn.aqx.ai/voices/gemma-uk.mp3) |
| `lcMyyd2HUfFzxdCaC4Ta` | Poppy | female | 11labs | [listen](https://cdn.aqx.ai/voices/poppy-uk.mp3) |
| `Fahco4VZzobUeiPqni1S` | Daniel | male | 11labs | [listen](https://cdn.aqx.ai/voices/daniel-uk.mp3) |
| `RKCbSROXui75bk1SVpy8` | James | male | 11labs | [listen](https://cdn.aqx.ai/voices/james-uk.mp3) |
| `1BUhH8aaMvGMUdGAmWVM` | Ben | male | 11labs | [listen](https://cdn.aqx.ai/voices/ben-uk.mp3) |
#### English (Australia)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `fCqNx624ZlenYx5PXk6M` | Grace | female | 11labs | [listen](https://cdn.aqx.ai/voices/grace-aus.mp3) |
| `ys3XeJJA4ArWMhRpcX1D` | Zoe | female | 11labs | [listen](https://cdn.aqx.ai/voices/zoe-aus.mp3) |
| `OluJZCsIVfyg64DC1NPq` | Sophia | female | 11labs | [listen](https://cdn.aqx.ai/voices/sophia-aus.mp3) |
| `aEO01A4wXwd1O8GPgGlF` | Simone | female | 11labs | [listen](https://cdn.aqx.ai/voices/simone-aus.mp3) |
| `w9rPM8AIZle60Nbpw7nl` | Michelle | female | 11labs | [listen](https://cdn.aqx.ai/voices/michelle-aus.mp3) |
| `DYkrAHD8iwork3YSUBbs` | Bruce | male | 11labs | [listen](https://cdn.aqx.ai/voices/bruce-aus.mp3) |
| `WLKp2jV6nrS8aMkPPDRO` | Wayne | male | 11labs | [listen](https://cdn.aqx.ai/voices/wayne-aus.mp3) |
#### Spanish (es-US)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `kPzsL2i3teMYv0FxEYQ6` | Sylvia (EN & Spanish) | female | 11labs | [listen](https://cdn.aqx.ai/voices/Sylvia-mono.wav) |
| `kcQkGnn0HAT2JRDQ4Ljp` | Luisa | female | 11labs | [listen](https://cdn.aqx.ai/voices/luisa.mp3) |
| `kjHz50TasdqbpbfK4uaN` | Maria | female | 11labs | [listen](https://cdn.aqx.ai/voices/maria-spanish.wav) |
| `T7QGPtToiqH4S8VlIkMJ` | Carlos | male | 11labs | [listen](https://cdn.aqx.ai/voices/carlos-spanish.wav) |
| `15bJsujCI3tcDWeoZsQP` | Santiago | male | 11labs | [listen](https://cdn.aqx.ai/voices/santiago-spanish.wav) |
#### French (fr-FR)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `FvmvwvObRqIHojkEGh5N` | Andréa | female | 11labs | [listen](https://cdn.aqx.ai/voices/Fr_Andrea.wav) |
| `XTyroWkQl32ZSd3rRVZ1` | Mathieu | male | 11labs | [listen](https://cdn.aqx.ai/voices/Fr_Mathieu.wav) |
| `K7gx0ylJdff0yjM2uVQS` | Stéphanie | female | 11labs | [listen](https://cdn.aqx.ai/voices/Fr_Stephanie.wav) |
| `j9RedbMRSNQ74PyikQwD` | Jean-François | male | 11labs | [listen](https://cdn.aqx.ai/voices/Fr_Jean-François.wav) |
#### Romanian (ro-RO)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `urzoE6aZYmSRdFQ6215h` | Ana Maria | female | 11labs | [listen](https://cdn.aqx.ai/voices/Ro_Ana_Maria.wav) |
| `gbLy9ep70G3JW53cTzFC` | Corina | female | 11labs | [listen](https://cdn.aqx.ai/voices/Ro_Corina.wav) |
#### German (de)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `aMSt68OGf4xUZAnLpTU8` | Sabine | female | 11labs | [listen](https://cdn.aqx.ai/voices/sabine-du.mp3) |
| `UgBBYS2sOqTuMpoF3BR0` | Markus | male | 11labs | [listen](https://cdn.aqx.ai/voices/markus-du.mp3) |
#### Hindi (hi-IN)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `qSV5UqvHBC0Widy71Esh` | Arjun | male | 11labs | [listen](https://cdn.aqx.ai/voices/arjun-hi.mp3) |
#### Hebrew (he-IL)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `Korean_SweetGirl` | רחל (Rachel) | female | minimax | [listen](https://cdn.aqx.ai/voices/female-1-hebrew.mp3) |
| `English_CalmWoman` | שרה (Sarah) | female | minimax | [listen](https://cdn.aqx.ai/voices/female-2-hebrew.mp3) |
#### Turkish (tr-TR)
| ID | Name | Gender | Provider | Preview |
|----|------|--------|----------|---------|
| `KoVIHoyLDrQyd4pGalbs` | Zeynep | female | 11labs | [listen](https://cdn.aqx.ai/voices/Zeynep_turkish.mp3) |
| `IuRRIAcbQK5AQk1XevPj` | Mehmet | male | 11labs | [listen](https://cdn.aqx.ai/voices/Mehmet_turkish.mp3) |
#### Multilanguage
Use these when the agent must speak multiple languages in one call.
| ID | Name | Gender | Provider |
|----|------|--------|----------|
| `Crm8VULvkVs5ZBDa1Ixm` | Andrea | female | 11labs |
| `W3CFqXny6S1Yialy9vVf` | Kelcey | female | 11labs |
| `dmuSWOurMvNgYtdhjFFr` | Christopher | male | 11labs |
| `kdVjFjOXaqExaDvXZECX` | Burt | male | 11labs |
| `JZ3e95uoTACVf6tXaaEi` | Johnny | male | 11labs |
| `aTxZrSrp47xsP6Ot4Kgd` | Tiana | female | 11labs |
| `OOk3INdXVLRmSaQoAX9D` | Tiffany | female | 11labs |
| `P7x743VjyZEOihNNygQ9` | Charlene | female | 11labs |
| `77aEIu0qStu8Jwv1EdhX` | Joseph | male | 11labs |
| `ewxUvnyvvOehYjKjUVKC` | Andre | male | 11labs |
| `Z7HhYXzYeRsQk3RnXqiG` | Samuel | male | 11labs |
| `UgBBYS2sOqTuMpoF3BR0` | Tyler | male | 11labs |
| `uYXf8XasLslADfZ2MB4u` | Nicole | female | 11labs |
| `dMyQqiVXTU80dDl2eNK8` | Hannah | female | 11labs |
| `ZF6FPAbjXT4488VcRRnw` | Charlotte (UK) | female | 11labs |
| `19STyYD15bswVz51nqLf` | Gemma (UK) | female | 11labs |
| `lcMyyd2HUfFzxdCaC4Ta` | Poppy (UK) | female | 11labs |
| `Fahco4VZzobUeiPqni1S` | Daniel (UK) | male | 11labs |
| `RKCbSROXui75bk1SVpy8` | James (UK) | male | 11labs |
| `1BUhH8aaMvGMUdGAmWVM` | Ben (UK) | male | 11labs |
| `fCqNx624ZlenYx5PXk6M` | Grace (Australia) | female | 11labs |
| `ys3XeJJA4ArWMhRpcX1D` | Zoe (Australia) | female | 11labs |
| `OluJZCsIVfyg64DC1NPq` | Sophia (Australia) | female | 11labs |
| `aEO01A4wXwd1O8GPgGlF` | Simone (Australia) | female | 11labs |
| `w9rPM8AIZle60Nbpw7nl` | Michelle (Australia) | female | 11labs |
| `DYkrAHD8iwork3YSUBbs` | Bruce (Australia) | male | 11labs |
| `WLKp2jV6nrS8aMkPPDRO` | Wayne (Australia) | male | 11labs |
| `kPzsL2i3teMYv0FxEYQ6` | Sylvia (EN & Spanish) | female | 11labs |
| `kcQkGnn0HAT2JRDQ4Ljp` | Luisa | female | 11labs |
| `kjHz50TasdqbpbfK4uaN` | Maria (Spanish) | female | 11labs |
| `T7QGPtToiqH4S8VlIkMJ` | Carlos (Spanish) | male | 11labs |
| `15bJsujCI3tcDWeoZsQP` | Santiago (Spanish) | male | 11labs |
| `FvmvwvObRqIHojkEGh5N` | Andréa (French) | female | 11labs |
| `XTyroWkQl32ZSd3rRVZ1` | Mathieu (French) | male | 11labs |
| `K7gx0ylJdff0yjM2uVQS` | Stéphanie (French) | female | 11labs |
| `urzoE6aZYmSRdFQ6215h` | Ana Maria (Romanian) | female | 11labs |
| `gbLy9ep70G3JW53cTzFC` | Corina (Romanian) | female | 11labs |
| `j9RedbMRSNQ74PyikQwD` | Jean-François (French) | male | 11labs |
| `qSV5UqvHBC0Widy71Esh` | Arjun (Hindi) | male | 11labs |
| `aMSt68OGf4xUZAnLpTU8` | Sabine (German) | female | 11labs |
| `UgBBYS2sOqTuMpoF3BR0` | Markus (German) | male | 11labs |
### Available `agentTypeId` values
The chosen agent type must match **both the language and the campaign type** of the campaign referenced by `campaignId`. Otherwise the request fails with a validation error.
Campaign types are: `inbound`, `outbound`, `web`, `messages`.
#### Inbound
| ID | Title | Language |
|----|-------|----------|
| `0aedeff4-a996-4183-b19c-1a5f7c42eead` | Create from Scratch | en-US |
| `d78df152-f9fe-4737-8f56-d5c72569846f` | Customer Service Agent | en-US |
| `54a9fb74-0b57-4291-b563-003a05887985` | Receptionist | en-US |
| `b13c9418-358a-48c1-914d-241342b34c7f` | Complaint Resolution Agent | en-US |
| `e5770e04-bfe6-40ac-b5e2-33ec825d5d9d` | Retention Specialist | en-US |
| `fb48b616-40a6-4058-97bb-cd32f8361f53` | Sıfırdan oluşturmak | tr-TR |
| `d4da399d-f0dd-49e7-bf3a-dba3ef7637bf` | Crear desde cero | es-US |
| `833693b8-2cee-42ad-b6cd-91cd5893b7a6` | Créer à partir de zéro | fr-FR |
| `4254e00a-debe-4d98-9bef-0f2ac72d4a85` | Creați de la zero | ro-RO |
| `87582277-e65a-462a-a608-6150886cb37a` | Create from scratch | hi-IN |
| `0242c5ca-e2a9-434b-959e-257268131683` | להתחיל מאפס | he-IL |
| `87582277-e65a-462a-a608-6150886cb37b` | Von Grund auf erstellen | de |
| `4bc22db8-42ca-4512-bf5d-99d7cff65e25` | Create from Scratch | multilanguage |
#### Outbound
| ID | Title | Language |
|----|-------|----------|
| `0aedeff4-a996-4183-b19c-1a5f7c42eead` | Create from Scratch | en-US |
| `460e200d-d15e-4204-94d6-5883d9f5c0d9` | Sales Agent | en-US |
| `14c269b7-2a9c-4808-bb1c-09e4c6851043` | Customer Service Agent | en-US |
| `53c96fe3-a27f-4e7e-9dec-83428aad973f` | Lead Qualification Agent | en-US |
| `fb48b616-40a6-4058-97bb-cd32f8361f53` | Sıfırdan oluşturmak | tr-TR |
| `d4da399d-f0dd-49e7-bf3a-dba3ef7637bf` | Crear desde cero | es-US |
| `833693b8-2cee-42ad-b6cd-91cd5893b7a6` | Créer à partir de zéro | fr-FR |
| `4254e00a-debe-4d98-9bef-0f2ac72d4a85` | Creați de la zero | ro-RO |
| `87582277-e65a-462a-a608-6150886cb37a` | Create from scratch | hi-IN |
| `0242c5ca-e2a9-434b-959e-257268131683` | להתחיל מאפס | he-IL |
| `87582277-e65a-462a-a608-6150886cb37b` | Von Grund auf erstellen | de |
| `4bc22db8-42ca-4512-bf5d-99d7cff65e25` | Create from Scratch | multilanguage |
#### Web
| ID | Title | Language |
|----|-------|----------|
| `0aedeff4-a996-4183-b19c-1a5f7c42eead` | Create from Scratch | en-US |
| `48107f46-a0e1-47d4-abba-87b404fd001e` | Sales | en-US |
| `5aa34180-9b4e-4c8b-a194-0b2fdfa512b4` | Customer Service Agent | en-US |
| `3e5bfe73-722d-49b5-9903-118e304752e8` | Technical Support Agent | en-US |
| `7aa7ad61-17a9-4b6e-b415-a68318e671aa` | Multilingual Support Agent | es-US |
| `fb48b616-40a6-4058-97bb-cd32f8361f53` | Sıfırdan oluşturmak | tr-TR |
| `d4da399d-f0dd-49e7-bf3a-dba3ef7637bf` | Crear desde cero | es-US |
| `833693b8-2cee-42ad-b6cd-91cd5893b7a6` | Créer à partir de zéro | fr-FR |
| `4254e00a-debe-4d98-9bef-0f2ac72d4a85` | Creați de la zero | ro-RO |
| `87582277-e65a-462a-a608-6150886cb37a` | Create from scratch | hi-IN |
| `0242c5ca-e2a9-434b-959e-257268131683` | להתחיל מאפס | he-IL |
| `87582277-e65a-462a-a608-6150886cb37b` | Von Grund auf erstellen | de |
| `4bc22db8-42ca-4512-bf5d-99d7cff65e25` | Create from Scratch | multilanguage |
#### Messages
| ID | Title | Language |
|----|-------|----------|
| `messages-en-US` | Messages Agent | en-US |
| `messages-tr-TR` | Mesaj Ajanı | tr-TR |
| `messages-es-US` | Agente de Mensajes | es-US |
| `messages-fr-FR` | Agent de Messages | fr-FR |
| `messages-ro-RO` | Agent de Mesaje | ro-RO |
| `messages-hi-IN` | मैसेज एजेंट | hi-IN |
| `messages-he-IL` | סוכן הודעות | he-IL |
| `messages-de` | Nachrichten-Agent | de |
| `messages-multilanguage` | Messages Agent | multilanguage |
Authentication
api-keystring
Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.
Path parameters
campaignId
Request
This endpoint expects an object.
Name
Display name for the agent
VoiceId
Voice template ID
agentTypeId
Agent-type template ID. When provided, scripts and settings are resolved from the template. When omitted, AgentTypeName, PreScript, and PostScript are required.
AgentTypeName
PreScript
PostScript
BackgroundSound
Model
Stability
SimilarityBoost
Speed
OptimizeStreamingLatency
Response
Agent created
campaignId
assistantId
Errors
400
Bad Request Error
404
Not Found Error
500
Internal Server Error
