POST /aiagents
Create a new AI Agent for the selected account.
agent_name, voice and business_description are required. greeting is optional; when omitted, AVANSER stores friendly and the created agent returned in this response contains that value.
If instructions are omitted or empty AVANSER generates them from the submitted agent details, and agent_role, business_type and business_name are required as well, together with custom_agent_role or custom_business_type when the matching field is set to other.
The new agent is created without any tracking number assigned to it: configure it as the answer point of a service to have it answer calls.
Advanced settings are not part of this request, a new agent starts with the default advanced settings and is configured with the Update AI Agent Advanced Settings request.
A failed request reports every field that did not validate in errors, keyed by field name:
| reason | field |
|---|---|
required | agent_name, voice, business_description, and agent_role, business_type, business_name when the instructions are generated |
required when agent_role is other | custom_agent_role |
required when business_type is other | custom_business_type |
invalid email | contact_email |
invalid | agent_role, business_type, greeting, voice, when the submitted value is not one of the keys List Agent Options reports |
4000 characters max | instructions |