Skip to main content
POST
/
v1
/
agents
Create Agent
curl --request POST \
  --url https://api.sigmamind.ai/v1/agents \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "instructions": "You are a helpful customer support assistant. Answer concisely and professionally.",
  "agentName": "Auralis",
  "welcomeMessageType": "static",
  "welcomeMessage": "Welcome to our service! How can I assist you today?",
  "agentSettings": {
    "language": "en_US",
    "aiStartsConversation": true,
    "backgroundSound": "keyboard_typing",
    "interruptionSensitivity": 0.05,
    "globalPrompt": "You are a professional virtual assistant. Always respond politely and keep answers concise.",
    "endCallOnSilenceDuration": 30,
    "maxCallDuration": 40,
    "llmModel": "gpt-4o-mini",
    "voiceId": "elevenlabs_SGbOfpm28edC83pZ9iGb",
    "voiceModelId": "eleven_turbo_v2_5",
    "enablePostConversationInsights": true,
    "postConversationInsightsLlmModel": "gpt-4o-mini",
    "webhooks": [
      {
        "name": "My Webhook",
        "url": "https://example.com/webhook",
        "events": [
          "conversation_started"
        ]
      }
    ],
    "postConversationInsights": [
      {
        "insightName": "conversation summary",
        "analysisInstructions": "<string>",
        "dataType": "string",
        "options": [
          "Interested",
          "Not Interested",
          "Follow Up Later"
        ]
      }
    ]
  },
  "tools": [
    {
      "type": "voice_transfer_call",
      "transferTo": "+9187788XXXXX",
      "description": "<string>"
    }
  ]
}
'
{
  "instructions": "You are a helpful customer support assistant. Answer concisely and professionally.",
  "agentName": "Auralis",
  "welcomeMessageType": "static",
  "welcomeMessage": "Welcome to our service! How can I assist you today?",
  "agentSettings": {
    "language": "en_US",
    "aiStartsConversation": true,
    "backgroundSound": "keyboard_typing",
    "interruptionSensitivity": 0.05,
    "globalPrompt": "You are a professional virtual assistant. Always respond politely and keep answers concise.",
    "endCallOnSilenceDuration": 30,
    "maxCallDuration": 40,
    "llmModel": "gpt-4o-mini",
    "voiceId": "elevenlabs_SGbOfpm28edC83pZ9iGb",
    "voiceModelId": "eleven_turbo_v2_5",
    "enablePostConversationInsights": true,
    "postConversationInsightsLlmModel": "gpt-4o-mini",
    "webhooks": [
      {
        "name": "My Webhook",
        "url": "https://example.com/webhook",
        "events": [
          "conversation_started"
        ]
      }
    ],
    "postConversationInsights": [
      {
        "insightName": "conversation summary",
        "analysisInstructions": "<string>",
        "dataType": "string",
        "options": [
          "Interested",
          "Not Interested",
          "Follow Up Later"
        ]
      }
    ]
  },
  "tools": [
    {
      "type": "voice_transfer_call",
      "transferTo": "+9187788XXXXX",
      "description": "<string>",
      "transferSettings": {
        "transferType": "warm",
        "ringingDuration": 40,
        "waitForParticipantAnswer": true,
        "enableWhisperMessage": true,
        "whisperMessage": "<string>",
        "whisperMessageType": "static",
        "enableThreeWayMessage": true,
        "threeWayMessage": "<string>",
        "threeWayMessageType": "static",
        "customHeaders": {}
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.

Body

application/json
​
instructions
string
required

Instructional prompt provided to the agent to guide its behavior, tone, and task execution.

Example:

"You are a helpful customer support assistant. Answer concisely and professionally."

​
agentName
string

The name of the agent.

Maximum string length: 128
Example:

"Auralis"

​
welcomeMessageType
enum<string>

Specifies whether the welcome message is static or dynamically generated from a prompt.

Available options:
static,
prompt
Example:

"static"

​
welcomeMessage
string

The content of the welcome message. If 'welcomeMessageType' is 'static', this contains the exact message shown to the user. If it is 'prompt', this contains the prompt used to generate the welcome message dynamically.

Example:

"Welcome to our service! How can I assist you today?"

​
agentSettings
object

Configuration settings that control the agent's runtime behavior.

​
tools
object[]

Transfers the active voice call to another number

Response

Created

​
instructions
string
required

Instructional prompt provided to the agent to guide its behavior, tone, and task execution.

Example:

"You are a helpful customer support assistant. Answer concisely and professionally."

​
agentName
string

The name of the agent.

Maximum string length: 128
Example:

"Auralis"

​
welcomeMessageType
enum<string>

Specifies whether the welcome message is static or dynamically generated from a prompt.

Available options:
static,
prompt
Example:

"static"

​
welcomeMessage
string

The content of the welcome message. If 'welcomeMessageType' is 'static', this contains the exact message shown to the user. If it is 'prompt', this contains the prompt used to generate the welcome message dynamically.

Example:

"Welcome to our service! How can I assist you today?"

​
agentSettings
object

Configuration settings that control the agent's runtime behavior.

​
tools
object[]

Transfers the active voice call to another number