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

# Create Conversation

The `createConversation` mutation creates a new conversation in a specified domain for conducting AI-powered data analysis sessions.

## Signature

```graphql theme={null}
createConversation(domainId: String!, hidden: Boolean!): ID!
```

## Arguments

<ParamField path="domainId" type="String!" required>
  The unique identifier of the domain where the conversation will be created.
</ParamField>

<ParamField path="hidden" type="Boolean!" required>
  Whether the conversation should be hidden from the user interface.
</ParamField>

## Response

Returns an `ID` representing the unique identifier of the newly created conversation.

## Usage example

Create a new conversation for data analysis:

```graphql theme={null}
mutation CreateConversation(
  $domainId: String!
  $hidden: Boolean!
) {
  id: createConversation(
    domainId: $domainId
    hidden: $hidden
  )
}
```

<RequestExample>
  ```bash Request theme={null}
  curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <jwt_token>" \
    -d '{
      "query": "mutation CreateConversation($domainId: String!, $hidden: Boolean!) { id: createConversation(domainId: $domainId, hidden: $hidden) }",
      "variables": {
        "domainId": "domain_123456789",
        "hidden": false
      }
    }' \
    https://{ACCOUNT}.askwisdom.ai/graphql
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "id": "conv_987654321"
    }
  }
  ```
</ResponseExample>

## Related operation

<CardGroup cols={2}>
  <Card title="Send User Message" icon="message" href="/integrations/graphql-api/mutations/chat/send-user-message">
    Send a message to the conversation
  </Card>
</CardGroup>