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

# Create a conversation

> Create a new conversation without sending a message. This is a lightweight endpoint that only creates a contact and chat record, skipping AI processing, similarity search, and smart tag processing. Ideal for integrations that need a conversation ID quickly.



## OpenAPI

````yaml post /api/v2/conversations/create
openapi: 3.0.1
info:
  title: LiveChatAI API v2
  description: >-
    LiveChatAI API v2 - Build powerful AI-powered customer support experiences.
    This API follows REST principles with predictable, resource-oriented URLs,
    JSON responses, and standard HTTP methods.
  version: 2.0.0
servers:
  - url: https://app.livechatai.com
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/v2/conversations/create:
    post:
      tags:
        - Conversations
      summary: Create a conversation
      description: >-
        Create a new conversation without sending a message. This is a
        lightweight endpoint that only creates a contact and chat record,
        skipping AI processing, similarity search, and smart tag processing.
        Ideal for integrations that need a conversation ID quickly.
      requestBody:
        required: true
        description: Parameters for creating a new conversation
        content:
          application/json:
            schema:
              type: object
              required:
                - agentId
              properties:
                agentId:
                  type: string
                  example: clx1234567890abcdef
                  description: ID of the agent (chatbot) to create the conversation for
                contactId:
                  type: string
                  example: contact_1234567890
                  description: >-
                    Optional existing contact ID. If not provided, a new contact
                    will be created.
                integrationType:
                  type: string
                  enum:
                    - WHATSAPP
                    - SLACK
                  example: WHATSAPP
                  description: Optional integration type for the conversation
                ip:
                  type: string
                  example: 192.168.1.1
                  description: >-
                    Optional client IP address (used when creating a new
                    contact)
                country:
                  type: string
                  example: US
                  description: >-
                    Optional client country code (used when creating a new
                    contact)
      responses:
        '200':
          description: Conversation created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      conversationId:
                        type: string
                        example: chat_1234567890
                        description: ID of the created conversation
                      contactId:
                        type: string
                        example: contact_1234567890
                        description: ID of the contact (existing or newly created)
        '400':
          description: >-
            Bad request - Missing or invalid parameters (e.g., agentId is
            required).
        '401':
          description: Unauthorized access
        '403':
          description: Access denied - Workspace suspended.
        '404':
          description: Agent or contact not found.
        '500':
          description: An internal server error occurred.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````