Skip to main content
POST
/
admin
/
assistants
Create Assistant
curl --request POST \
  --url https://api.decodahealth.com/admin/assistants \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "firstName": "<string>",
  "timezone": "<string>",
  "assistantType": "SCHEDULER",
  "modality": "VOICE",
  "phoneNumber": "<string>",
  "customPrompt": "<string>",
  "beginSentenceTemplate": "<string>",
  "model": "gemini-2.5-flash",
  "tools": [
    "<string>"
  ],
  "fallbackPhoneNumber": "<string>",
  "recurringEvents": [],
  "primaryLocationId": "<string>"
}
'
{
  "id": "<string>",
  "firstName": "<string>",
  "assistantType": "SCHEDULER",
  "timezone": "<string>",
  "description": "<string>",
  "customPrompt": "<string>",
  "modality": "VOICE",
  "beginSentenceTemplate": "<string>",
  "model": "gemini-2.5-flash",
  "tools": [
    "<string>"
  ],
  "enabled": true,
  "phoneNumber": "<string>",
  "fallbackPhoneNumber": "<string>",
  "isArchived": true,
  "isDefault": true,
  "primaryLocationId": "<string>",
  "recurringEvents": []
}

Headers

TENANT
string
required

The tenant you are making this request on behalf of

API-KEY
string
required

Your api key

Body

application/json
firstName
string
required
timezone
string
required
assistantType
enum<string>
required
Available options:
SCHEDULER,
BILLER,
NOTE_TAKER,
NOTE_UPLOADER,
CALL_SUMMARIZER,
FORM_ASSISTANT,
INBOUND_CALL,
CALL_REMINDER,
CALL_FOLLOW_UP,
CALL_LAB_TECHNICIAN,
INBOUND_TEXT
modality
enum<string>
required
Available options:
VOICE,
TEXT
phoneNumber
string
required
customPrompt
string | null
beginSentenceTemplate
string | null
model
enum<string> | null
Available options:
gemini-2.5-flash,
claude-3-7-sonnet,
claude-3-5-haiku,
gpt-4.1,
gpt-4o-realtime-preview,
gpt-4o-mini-realtime-preview,
gpt-4o,
gpt-4o-mini,
gemini-2.0-flash,
gemini-2.5-flash,
gemini-2.5-flash-preview-05-20,
gemini-2.5-flash-lite,
gemini-live
tools
string[] | null
fallbackPhoneNumber
string | null
recurringEvents
RecurringEventUpdate · object[]
primaryLocationId
string | null

Response

Successful Response

id
string
required
firstName
string
required
assistantType
enum<string>
required
Available options:
SCHEDULER,
BILLER,
NOTE_TAKER,
NOTE_UPLOADER,
CALL_SUMMARIZER,
FORM_ASSISTANT,
INBOUND_CALL,
CALL_REMINDER,
CALL_FOLLOW_UP,
CALL_LAB_TECHNICIAN,
INBOUND_TEXT
timezone
string
required
description
string | null
customPrompt
string | null
modality
enum<string> | null
Available options:
VOICE,
TEXT
beginSentenceTemplate
string | null
model
enum<string> | null
Available options:
gemini-2.5-flash,
claude-3-7-sonnet,
claude-3-5-haiku,
gpt-4.1,
gpt-4o-realtime-preview,
gpt-4o-mini-realtime-preview,
gpt-4o,
gpt-4o-mini,
gemini-2.0-flash,
gemini-2.5-flash,
gemini-2.5-flash-preview-05-20,
gemini-2.5-flash-lite,
gemini-live
tools
string[] | null
enabled
boolean | null
phoneNumber
string | null
fallbackPhoneNumber
string | null
isArchived
boolean | null
isDefault
boolean | null
primaryLocationId
string | null
recurringEvents
RecurringEventDetail · object[]