POSThttps://core-api.heysadie.ai/assistants

Create assistant

Create a new assistant that will handle calls on behalf of your business (restaurant, hotel, car rental, etc). > ⚠️ **Important-Note:** All newly created assistants are automatically provisioned on **Core-V2**, which introduces enhanced latency performance and improved voice quality. --- You can configure its voice, behavior, tools, phone logic, and how it summarizes or classifies the calls. - `name`: The display name of the assistant (e.g., "Sadie", "Alex"). - `voiceId`: The voice the assistant will use to speak. - `transcriberId`: The engine used to convert speech to text. - `modelId`: The LLM that powers the assistant's logic and responses (e.g., GPT-4). - `developerPrompt`: Lets you inject your own section into the default system prompt. Example: "Always ask for membership ID before confirming a reservation." - `parameters`: A JSON object with dynamic values like `{{opening_hours}}` or `{{branch_name}}`. These values can be inserted in the prompt. - `recordingEnabled`: Boolean. If true, calls are recorded. - `failoverNumber`: The phone number to forward the call to if the assistant fails or needs to escalate. - `failoverMode`: Boolean. If true, the call will be forwarded to the failover number. - `phoneNumberId`: ID of the number this assistant is linked to. - `firstMessage`: What the assistant says at the start of the call. Example: "Hi! You've reached Joe's Pizza. How can I help?" - `toolIds`: List of tool IDs the assistant is allowed to use during a call. - `timezone`: The timezone of the business (e.g., "Australia/Sydney"). - `address`: The business address. - `endOfCallMessage`: The last thing the assistant says before hanging up. Example: "Thanks for calling — have a great day!" - `phoneNumberPassThrough`: If true, the assistant can use the caller's number during the call (e.g., "Would you like to use the number ending in 595?"). If false, it will always ask for the number. - `summaryPrompt`: A prompt to guide how the assistant summarizes the call at the end. Can be made short, long, or focused on certain topics. - `structuredDataPrompt`: Works with `categories` to define when the assistant should classify a call as "booking", "edit", "cancel", etc. - `categories`: A list of string values representing what type of call this is. Example: ["booking", "edit", "cancel"] - `promptId`: The ID of the prompt associated with the assistant, if not provided the default prompt will be used. - `backgroundSound`: Whether the assistant has a background sound. - `serverUrl`: The webhook URL override for the assistant. - `notifications`: Array of notification webhook URLs. New URLs will be appended to existing ones (not replaced). - `csatFeedback`: Whether CSAT (Customer Satisfaction) feedback is enabled for this assistant. Defaults to false if not provided. - `transferMode`: Transfer mode behavior for escalations. Defaults to 'cold-transfer' if not provided. - `warmWhisperDelaySeconds`: Warm-transfer whisper delay in seconds. Integer from 0 to 30. Defaults to 0 when omitted. - `settings`: (Optional) Per-assistant settings container. Currently holds `conversationConfig`; additional setting categories will be added here in the future. - `conversationConfig`: Conversation timing configuration with four optional sub-plans: - `endpointingPlan`: `mode` ("fixed" | "dynamic" — dynamic adapts the delay to the caller's pause pacing), `minDelay` / `maxDelay` — silence thresholds (seconds) before the agent responds. - `turnDetectionPlan`: `timeout` (seconds) and `unlikelyThreshold` (0-1 probability). - `vadPlan`: `minSpeechDuration`, `minSilenceDuration`, `prefixPaddingDuration` — low-level VAD in seconds. - `interruptionPlan`: `minDuration` (0-5 seconds of sustained caller speech before a barge-in stops the agent) and `minWords` (0-10 transcribed words required to register an interruption). - `deliveryMode`: Speech delivery style — `"none"` (default), `"emotion_tagging"`, or `"expressive"`. - `"emotion_tagging"`: Adds consistent delivery using emotion tags picked by a classifier (at most one per response). Works with Cartesia Sonic 3 and 3.5, and ElevenLabs v3; other voice models use their normal delivery. English calls only. - `"expressive"`: The AI controls its own delivery per response — emotion, pacing, pauses, and natural sounds. Works with Cartesia and Fish Audio voices; other voice models use their normal delivery. - `expressiveOptions`: (Only used when `deliveryMode` is `"expressive"`.) Sparse overrides on the default expressive behavior — omitted fields keep the defaults (full sound vocabulary, light fillers, delivery matched to the moment). Set to `null` to clear all overrides. - `disfluencies`: Filler words such as "um" / "uh". Defaults to on; set `false` to opt out. - `nonverbalSounds`: `true` keeps every sound, `false` disables all, or an object toggling categories individually: `laughing`, `breathing`, `sighing`, `crying`, `vocalizing` (humming, sing-song), `mouthSounds` (tsk, tongue-click), `reflexSounds` (cough, throat-clear, yawn). - `pace`: `"slow"` | `"normal"` | `"fast"`. Omit to let the AI pace itself. - `instructionsAppend`: Free-text delivery rules added on top of the defaults (max 2000 chars). - `emotionTaggingEnabled`: Legacy boolean opt-in for emotion tagging, superseded by `deliveryMode`. Still honored when `deliveryMode` is absent. All fields optional. Omitted values use agent defaults. Set to `null` to clear. Example: a restaurant assistant with a friendly tone, set to timezone "Europe/London", uses tools like "GetMenu" and "BookTable", and always ends with "Thanks for calling — enjoy your meal!" Make sure your `parameters` match what's inside your developerPrompt — e.g., if you write "We are open {{opening_hours}}", then `parameters` should include `{ "opening_hours": "10am to 10pm" }`.

curl -X POST "https://core-api.heysadie.ai/assistants" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "0195f1e2-0000-7000-8000-000000000000",
    "transcriberId": "0195f1e2-0000-7000-8000-000000000000",
    "modelId": "0195f1e2-0000-7000-8000-000000000000"
  }'