Create an assistant

Creates a new assistant and provisions a phone number for it. The phone_number field on the response is assigned by the platform — callers cannot set or change it via this API. Cross-resource refs (prompt_id, knowledge_group_ids, etc.) are validated to belong to your organization before the assistant is saved.

Authorization

bearerAuth

AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Length1 <= length <= 100

description?string

Lengthlength <= 500

Default""

language*string

BCP-47-ish language code from the platform-supported list.

Value in

"de"
"en"
"fr"
"it"
"de-CH"
"es"
"pt"
"tr"
"sv"
"fi"

voice_id*string

Voice ID. Must be one of the values returned by GET /voices; an unknown or unavailable ID returns 400.

company_name*string

Length1 <= length <= 200

company_industry*string

Length1 <= length <= 200

introduction*string

Opening text in the assistant language. The platform stores it as the canonical original localized introduction and generates other supported-language variants asynchronously.

Length1 <= length <= 5000

record_call?boolean

speed?number

Voice playback rate multiplier. Some voices only support 0.8–1.2; out-of-range values for such voices return 400.

Range0.7 <= value <= 1.2

tts_style_level?number

Voice style level from 0 (calm) to 1 (expressive). Omit to use 0.5.

Multiple Of0.01

Range0 <= value <= 1

background_ambience?string

Background ambience bed mixed under the assistant voice during phone calls. Omit to use clean (no bed).

Value in

"clean"
"office"

interruptable?boolean

appointment_booking_enabled?boolean

contextual_asr_correction_enabled?boolean

Per-turn LLM correction of misrecognised proper nouns (names, companies, products) in caller transcripts, using the assistant's own contacts, employees, glossary and knowledge. Adds latency on turns that carry a candidate. Default false.

allow_preferred_language?boolean

whitelist?boolean

prompt_id?|

Match^[a-f0-9]{24}$

email_prompt_id?|

Match^[a-f0-9]{24}$

knowledge_group_ids?array<>

Default[]

glossary_group_ids?array<>

Default[]

pronunciation_group_ids?array<>

Default[]

forwarding_group_ids?array<>

Default[]

contact_group_ids?array<>

Default[]

calendar_ids?array<>

Itemsitems <= 1

Default[]

tool_ids?array<>

Default[]

analysis_ids?array<>

Default[]

Response Body

`application/json`

curl -X POST "https://example.com/assistants" \  -H "Content-Type: application/json" \  -d '{    "name": "Sarah",    "language": "de",    "voice_id": "cgSgspJ2msm6clMCkdW9",    "company_name": "Example GmbH",    "company_industry": "Logistics",    "introduction": "Hello, how can I help you today?"  }'

{  "data": {    "id": "string",    "name": "string",    "description": "string",    "language": "de",    "voice_id": "string",    "record_call": true,    "speed": 0.7,    "tts_style_level": 0,    "background_ambience": "clean",    "interruptable": true,    "appointment_booking_enabled": true,    "contextual_asr_correction_enabled": true,    "allow_preferred_language": true,    "whitelist": true,    "introduction": "string",    "company_name": "string",    "company_industry": "string",    "phone_number": "string",    "carrier": "string",    "prompt_id": "string",    "email_prompt_id": "string",    "knowledge_group_ids": [      "string"    ],    "glossary_group_ids": [      "string"    ],    "pronunciation_group_ids": [      "string"    ],    "forwarding_group_ids": [      "string"    ],    "contact_group_ids": [      "string"    ],    "calendar_ids": [      "string"    ],    "tool_ids": [      "string"    ],    "analysis_ids": [      "string"    ],    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}

Create an assistant

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

402application/json

403application/json

404application/json

409application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`