---
title: "Send Agent Message"
method: POST
path: "/v1/conversations/{id}/messages"
tags: ["Conversations"]
---

# Send Agent Message

`POST /v1/conversations/{id}/messages`

Sends a message from an agent to a customer

## Path parameters

- `id` string, uuid, required

## Request body

- ExternalSendMessage
  - `text` string, required
  - `agentId` union, required
    - string, uuid
    - string
  - `type` 1 | 2 | 3 | 4
  - `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

## Response `200`

Successful Response

- 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

## 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)