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

# Create conversation

`POST /v1/conversations`

Creates conversation

## Request body

- ExternalCreateConversation
  - `customerId` union, required
    - string, uuid
    - string
  - `startedAt` string, date-time, nullable
  - `subject` string, nullable
  - `messages` ExternalCreateMessage[], required
    - `text` string, required
    - `senderId` union, required
      - string, uuid
      - string
    - `side` string, required
    - `type` string
    - `channel` string
    - `cc` union
      - string[]
      - string[]
    - `attachments` Base64Attachment[], nullable
      - `filename` string, required
      - `content` string, binary, required
      - `contentType` string, required
    - `whatsappTemplateId` string, nullable
    - `subChannelIdentifier` string, nullable
  - `status` 'OPEN' | 'SNOOZED' | 'CLOSED' | 'PENDING'
  - `priority` union
    - 'NO_PRIORITY' | 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - 0 | 1 | 2 | 3 | 4
  - `tags` union
    - string[]
    - string[]
  - `customFields` object, nullable
  - `assignedAgentId` union
    - string, uuid
    - string
  - `assignedTeamId` string, uuid, nullable

## Response `200`

Successful Response

- ExternalConversation
  - `customerId` string, uuid, required
  - `customer` ExternalCustomer
    - `id` string, uuid, required
    - `externalUserId` string, nullable
    - `companyId` string, uuid, nullable
    - `accountId` string, uuid, nullable
    - `account` WebCompanySchemasExternalAccount
      - `name` string, nullable
      - `email` string, nullable
      - `website` string, nullable
      - `externalId` string, nullable
      - `customFields` object, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, email, nullable
    - `phoneNumber` string, nullable
    - `customFields` object, nullable
    - `defaultSenders` CustomerDefaultSenders
      - `sms` string, nullable
      - `email` string, nullable
    - `lastLoginTime` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `totalConversations` integer, nullable
    - `avgTimeToSolve` integer, nullable
    - `totalSessions` integer, nullable
    - `totalSessionTime` integer, nullable
    - `avgSessionTime` integer, required
  - `startedAt` string, date-time, required
  - `lastMessage` ExternalMessage
    - `id` integer, required
    - `side` string, required
    - `type` string, required
    - `createdAt` string, date-time, required
    - `sentAt` string, date-time, required
    - `agent` ExternalUser
      - `createdAt` string, date-time, nullable
      - `firstName` string, required
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `profileUrl` string, uri, nullable
      - `accessTypes` UserAccessType[], nullable
      - `id` string, uuid, required
    - `customer` ExternalCustomer
      - `id` string, uuid, required
      - `externalUserId` string, nullable
      - `companyId` string, uuid, nullable
      - `accountId` string, uuid, nullable
      - `account` WebCompanySchemasExternalAccount
        - `name` string, nullable
        - `email` string, nullable
        - `website` string, nullable
        - `externalId` string, nullable
        - `customFields` object, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `phoneNumber` string, nullable
      - `customFields` object, nullable
      - `defaultSenders` CustomerDefaultSenders
        - `sms` string, nullable
        - `email` string, nullable
      - `lastLoginTime` string, date-time, nullable
      - `createdAt` string, date-time, required
      - `totalConversations` integer, nullable
      - `avgTimeToSolve` integer, nullable
      - `totalSessions` integer, nullable
      - `totalSessionTime` integer, nullable
      - `avgSessionTime` integer, required
    - `text` string, required
    - `channel` string, nullable
    - `attachments` ExternalAttachment[]
      - `name` string, required
      - `url` string, required
      - `size` integer, nullable
    - `deliveryStatus` string, nullable
    - `failedReason` string, nullable
    - `deliveredAt` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `closedAt` string, date-time, nullable
  - `closedBy` string, uuid, nullable
  - `assignedAt` string, date-time, nullable
  - `assignedBy` string, uuid, nullable
  - `browser` string, nullable
  - `operatingSystem` string, nullable
  - `assignedAgent` ExternalUser
    - `createdAt` string, date-time, nullable
    - `firstName` string, required
    - `lastName` string, nullable
    - `email` string, email, nullable
    - `profileUrl` string, uri, nullable
    - `accessTypes` UserAccessType[], nullable
    - `id` string, uuid, required
  - `number` integer, nullable
  - `csat` CSATResponse
    - `score` string, nullable
    - `comment` string, nullable
  - `statistics` ConversationStatistics
    - `firstResponseTime` integer, nullable
    - `avgResponseTime` integer, nullable
    - `totalResolutionTime` integer, nullable
  - `escalatedAt` string, date-time, nullable
  - `updatedBy` union
    - string, uuid
    - string
  - `assignedAgentId` union
    - string, uuid
    - string
  - `subject` string, nullable
  - `status` 'OPEN' | 'SNOOZED' | 'CLOSED' | 'PENDING'
  - `priority` 'NO_PRIORITY' | 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
  - `tags` union
    - string[]
    - string[]
  - `customFields` object, nullable
  - `snoozedUntil` string, date-time, nullable
  - `assignedTeamId` string, uuid, nullable
  - `assignedToZeus` boolean, nullable
  - `id` string, uuid, required
  - `startedChannel` string, nullable
  - `startedSubChannel` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/atlas/apis/atlas-api.md) · [All operations](https://skmtc.net/atlas/apis/atlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlas/atlas-api/versions/d121925e599d/schema)