---
title: "Create a conversation"
method: POST
path: "/v1/conversations"
tags: ["Conversations"]
deprecated: true
---

# Create a conversation

`POST /v1/conversations`

> **Deprecated.**

## Request body

- union
  - CreateCallbackConversationInput
    - `channel` 'widget_chat' | 'phone' | 'voice_mail' | 'email' | 'contact_form' | 'callback' | 'facebook_messenger', required — The channel a conversation can be conducted on.
    - `direction` 'outbound' | 'inbound' | 'internal', required — The direction a conversation can be
    - `queue_id` string, required
    - `requester_id` string, required
    - `endpoint_id` string, required
    - `tags` string[] — A list of tag names.
  - CreateContactFormConversationInput
    - `channel` 'widget_chat' | 'phone' | 'voice_mail' | 'email' | 'contact_form' | 'callback' | 'facebook_messenger', required — The channel a conversation can be conducted on.
    - `requester_id` string, required
    - `email_integration_id` string, required
    - `tags` string[] — A list of tag names.
    - `subject` string
    - `message` object
      - `text` string, required
      - `content_type` 'Text' | 'Markdown' | 'Html'

## Response `200`

The conversation was created

- object
  - `data` Conversation, required
    - `id` integer, required — The id of the conversation. May also be referred to as the csid.
    - `created_at` string, required
    - `requester_id` string, required
    - `channel` 'widget_chat' | 'phone' | 'voice_mail' | 'email' | 'contact_form' | 'callback' | 'facebook_messenger', required — The channel a conversation can be conducted on.
    - `direction` 'outbound' | 'inbound' | 'internal', required — The direction a conversation can be
    - `queued_at` string
    - `queue_id` string
    - `status` 'open' | 'closed' | 'pending' | 'awaiting_pending', required
    - `status_updated_at` string
    - `attributes` object
    - `assigned_to` string
    - `assigned_at` string

---

[API](https://skmtc.dev/dixa/apis/integrations-api-deprecated.md) · [All operations](https://skmtc.dev/dixa/apis/integrations-api-deprecated/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dixa/integrations-api-deprecated/revisions/bb4e8372fb22/schema)