> ## Documentation Index
> Fetch the complete documentation index at: https://docs.closerx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Agent

> Creates a new AI call agent with default settings



## OpenAPI

````yaml POST /agent/create/
openapi: 3.1.0
info:
  title: CloserX.ai API
  description: >-
    The CloserX.ai API provides programmatic access to manage AI-powered calling
    operations, including agent creation, campaign management, contact handling,
    telephony integration, and more. This API enables seamless automation and
    integration with CRM systems, telephony providers, and other third-party
    services for enhanced client communication and business operations.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://app.closerx.ai/api
security:
  - api_key: []
paths:
  /agent/create/:
    post:
      description: Creates a new AI call agent with default settings
      parameters:
        - name: Company-Name
          in: header
          description: The name of the schema to be used for the request
          required: true
          schema:
            type: string
      responses:
        '200':
          description: AI call agent creation response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateAgentResponse'
        '400':
          description: unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreateAgentResponse:
      type: object
      required:
        - success
        - message
        - data
      properties:
        success:
          type: boolean
          description: Indicates whether the request was successful
        message:
          type: string
          description: Message describing the result of the request
        data:
          type: object
          required:
            - agent
            - llm
          properties:
            agent:
              type: object
              required:
                - pk
                - agent_name
                - agent_id
                - voice_id
                - language
                - interruption_sensitivity
                - voicemail
                - voicemail_message
                - end_call_after_silence
                - max_call_duration
                - reminder_trigger
                - ambient_sound
                - analysis_data
                - llm
                - voice_speed
                - voice_temperature
                - volume
                - enable_backchannel
                - normalize_for_speech
                - enable_transcription_formatting
                - reminder_trigger_ms
                - reminder_max_count
                - boosted_keywords
                - ambient_sound_volume
                - voicemail_detection_timeout_ms
                - begin_message_delay_ms
                - updated_at
                - is_locked
                - calendar_id
                - inbound_appoitment
                - ring_duration_sec
                - stt_mode
                - backchannel_words
                - backchannel_frequency
                - call_scheduling
                - agent_crm_type
                - voicemail_option
              properties:
                pk:
                  type: integer
                  description: Primary key for the AI call agent
                agent_name:
                  type: string
                  description: Name of the AI call agent
                agent_id:
                  type: string
                  description: Unique identifier for the AI call agent
                voice_id:
                  type: string
                  description: Identifier for the voice used by the agent
                language:
                  type: string
                  description: Language code or type (e.g., en-US, multi)
                interruption_sensitivity:
                  type: string
                  description: Sensitivity level for interruptions
                voicemail:
                  type: boolean
                  description: Indicates if voicemail is enabled
                voicemail_message:
                  type: string
                  nullable: true
                  description: Voicemail message content
                end_call_after_silence:
                  type: integer
                  description: Duration of silence before ending the call (in seconds)
                max_call_duration:
                  type: integer
                  description: Maximum call duration (in minutes)
                reminder_trigger:
                  type: integer
                  description: Time before triggering a reminder (in seconds)
                ambient_sound:
                  type: string
                  nullable: true
                  description: Ambient sound setting
                analysis_data:
                  type: array
                  description: Data for call analysis
                  items:
                    type: string
                llm:
                  type: integer
                  description: Identifier for the language model used
                voice_speed:
                  type: number
                  format: float
                  description: Speed of the voice
                voice_temperature:
                  type: number
                  format: float
                  description: Temperature setting for voice generation
                volume:
                  type: number
                  format: float
                  description: Volume level for the voice
                enable_backchannel:
                  type: boolean
                  description: Indicates if backchannel responses are enabled
                normalize_for_speech:
                  type: boolean
                  description: Indicates if speech normalization is enabled
                enable_transcription_formatting:
                  type: boolean
                  description: Indicates if transcription formatting is enabled
                reminder_trigger_ms:
                  type: integer
                  description: Reminder trigger time in milliseconds
                reminder_max_count:
                  type: integer
                  description: Maximum number of reminders
                boosted_keywords:
                  type: array
                  description: List of keywords to boost in processing
                  items:
                    type: string
                ambient_sound_volume:
                  type: number
                  format: float
                  description: Volume level for ambient sound
                voicemail_detection_timeout_ms:
                  type: integer
                  description: Timeout for voicemail detection in milliseconds
                begin_message_delay_ms:
                  type: integer
                  description: Delay before starting message in milliseconds
                updated_at:
                  type: string
                  format: date-time
                  description: Timestamp when the agent was last updated
                is_locked:
                  type: boolean
                  description: Indicates if the agent is locked
                calendar_id:
                  type: string
                  nullable: true
                  description: Identifier for associated calendar
                inbound_appoitment:
                  type: boolean
                  description: Indicates if inbound appointment scheduling is enabled
                ring_duration_sec:
                  type: integer
                  description: Ring duration in seconds
                stt_mode:
                  type: string
                  description: Speech-to-text mode (e.g., fast)
                backchannel_words:
                  type: string
                  nullable: true
                  description: Words used for backchannel responses
                backchannel_frequency:
                  type: number
                  format: float
                  description: Frequency of backchannel responses
                call_scheduling:
                  type: boolean
                  description: Indicates if call scheduling is enabled
                agent_crm_type:
                  type: string
                  nullable: true
                  description: Type of CRM integration for the agent
                voicemail_option:
                  type: object
                  description: Voicemail options for the agent
                  properties:
                    action:
                      type: object
                      properties:
                        type:
                          type: string
                          description: Type of voicemail action (e.g., hangup)
            llm:
              type: object
              required:
                - pk
                - model
                - states
                - s2s_model
                - model_temperature
                - general_prompt
                - general_tools
                - begin_message
                - ghl_book_meeting
                - price_set_per_model
                - custom_message
              properties:
                pk:
                  type: integer
                  description: Primary key for the language model
                model:
                  type: string
                  description: Name of the language model
                states:
                  type: string
                  nullable: true
                  description: State settings for the model
                s2s_model:
                  type: string
                  nullable: true
                  description: Speech-to-speech model identifier
                model_temperature:
                  type: string
                  description: Temperature setting for the model
                general_prompt:
                  type: string
                  description: General prompt for the model
                general_tools:
                  type: array
                  description: List of tools available to the model
                  items:
                    type: object
                begin_message:
                  type: string
                  description: Initial message for the model
                ghl_book_meeting:
                  type: boolean
                  description: Indicates if meeting booking is enabled
                price_set_per_model:
                  type: string
                  description: Price set for the model
                custom_message:
                  type: string
                  nullable: true
                  description: Custom message for the model
    Error:
      required:
        - success
        - message
        - data
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: api_key

````