> ## 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 Quick Campaign

> Creates a new quick call campaign, including key campaign details such as Campaign Name, Selected AI Agent, Selected Phone Number, and Enable Number Rotation settings.



## OpenAPI

````yaml POST /quick_campaign/
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:
  /quick_campaign/:
    post:
      summary: Create a new Quick Campaign
      description: >-
        Creates a new quick call campaign, including key campaign details such
        as Campaign Name, Selected AI Agent, Selected Phone Number, and Enable
        Number Rotation settings.
      parameters:
        - name: Company-Name
          in: header
          description: The name of the schema to be used for the request
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateQuickCampaignRequest'
      responses:
        '200':
          description: Quick Campaign created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateQuickCampaign'
        '400':
          description: Invalid request or missing data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreateQuickCampaignRequest:
      type: object
      properties:
        name:
          type: string
          description: Name of the quick campaign
          example: Quick Follow-up Campaign
        new_agent:
          type: integer
          description: ID of the AI agent assigned to the campaign
          example: 123
        calling_number:
          type: string
          description: Phone number used for outbound calls
          example: '+18446020950'
        enable_number_rotation:
          type: boolean
          description: Whether number rotation is enabled
          example: false
        number_dict:
          type: object
          description: Whether number rotation is enabled
          example: {}
        direction:
          type: string
          description: Call direction
          enum:
            - Outbound
            - Inbound
          example: Outbound
      required:
        - name
        - new_agent
        - calling_number
        - enable_number_rotation
        - direction
    CreateQuickCampaign:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether the quick campaign was created successfully
          example: true
        message:
          type: string
          description: A message confirming the status of the quick campaign creation
          example: quick campaign created
        data:
          type: object
          properties:
            quick_campaign:
              type: object
              properties:
                id:
                  type: string
                  description: Unique identifier for the quick campaign
                  example: quickcamp25fdd9d6
                name:
                  type: string
                  description: Name of the quick campaign
                  example: ja(test)
                calling_number:
                  type: string
                  description: The calling number assigned to the quick campaign
                  example: '+15076371471'
                status:
                  type: string
                  description: >-
                    The current status of the campaign (e.g., 'running',
                    'paused')
                  example: running
                direction:
                  type: string
                  description: >-
                    The call direction for the quick campaign (either 'Outbound'
                    or 'Inbound')
                  example: Outbound
                is_rescheduled:
                  type: boolean
                  description: Indicates whether the campaign is rescheduled
                  example: false
                number_rotation:
                  type: boolean
                  description: >-
                    Indicates whether number rotation is enabled for the quick
                    campaign
                  example: false
                rotate_number_after_calls:
                  type: number
                  description: Number of calls after which to rotate the calling number
                  example: 1
                release_buyed_when:
                  type: string
                  description: Specifies when the purchased numbers should be released
                  example: never
                created_at:
                  type: string
                  format: date-time
                  description: Timestamp when the quick campaign was created
                  example: '2025-08-23T12:42:49.768952Z'
                updated_at:
                  type: string
                  format: date-time
                  description: Timestamp when the quick campaign was last updated
                  example: '2025-08-23T12:42:49.768961Z'
                agent:
                  type: object
                  description: The agent assigned to the quick campaign (if available)
                  example: null
                new_agent:
                  type: integer
                  description: Unique ID of the agent selected for the quick campaign
                  example: 542
                knowledge_base:
                  type: object
                  description: >-
                    The knowledge base associated with the quick campaign (if
                    available)
                  example: null
                calling_number_pool:
                  type: array
                  description: List of calling numbers available for the quick campaign
                  example: []
    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

````