---
title: "Create Communication"
method: POST
path: "/v2/Conversations/{ConversationId}/Communications"
tags: ["ConversationsV2Communication"]
---

# Create Communication

`POST /v2/Conversations/{ConversationId}/Communications`

Create a Communication.

## Request body

- object
  - `author` object, required
    - `address` string, required
    - `channel` 'VOICE' | 'SMS' | 'RCS' | 'WHATSAPP' | 'CHAT', required — Channel type for a Communication address.
    - `participantId` string
  - `content` union, required — The content of the Communication.
    - object
      - `type` 'TEXT', required
      - `text` string, required
    - object
      - `type` 'TRANSCRIPTION', required
      - `text` string, required
      - `transcription` object
        - `channel` integer
        - `confidence` number
        - `engine` string
  - `channelId` string
  - `recipients` object[], required
    - `address` string, required
    - `channel` 'VOICE' | 'SMS' | 'RCS' | 'WHATSAPP' | 'CHAT', required — Channel type for a Communication address.
    - `participantId` string
  - `occurredAt` string, date-time — Timestamp when this Communication occurred. If omitted, the server uses the current time.

## Response `201`

Created

- object
  - `id` string, required — Communication ID.
  - `conversationId` string, required — Conversation ID.
  - `accountId` string, required — Account ID.
  - `author` ConversationsV2ParticipantAddress, required
    - `address` string, required — The address value formatted according to channel type: - SMS/VOICE: E.164 phone number (such as "+18005550100") - WHATSAPP: Phone number with whatsapp prefix (such as "whatsapp:+18005550100") - RCS: Sender ID or phone number with rcs prefix (such as "rcs:brand_acme_agent" or "rcs:+18005550100") - CHAT: Customer-defined string identifier
    - `channel` 'VOICE' | 'SMS' | 'RCS' | 'WHATSAPP' | 'CHAT', required — Channel type for a Communication address.
    - `participantId` string — Participant ID associated with this address.
  - `content` union, required — The content of the Communication using type field for discrimination.
    - ConversationsV2ContentText
      - `type` 'TEXT', required — Content type discriminator.
      - `text` string, required — Message text content.
    - ConversationsV2ContentTranscription
      - `type` 'TRANSCRIPTION', required — Content type discriminator.
      - `text` string, required — Transcribed text.
      - `transcription` object — Transcription metadata.
        - `channel` integer — Audio channel identifier (0 for inbound, 1 for outbound).
        - `confidence` number, float — Overall confidence score for the transcription (0.0-1.0).
        - `engine` string — Transcription engine used.
        - `words` object[] — Word-level transcription data with timing information.
          - `text` string, required — The transcribed word.
          - `startTime` string, date-time — Start timestamp of this word.
          - `endTime` string, date-time — End timestamp of this word.
  - `channelId` string — Channel-specific reference ID.
  - `resourceId` string — External resource identifier for this Communication (e.g. MessageSid for SMS/RCS/WhatsApp, TranscriptionSid + MessageIndex for Voice). When set, used for Communication deduplication/uniqueness within a Conversation.
  - `recipients` object[], required — Communication recipients.
    - `address` string, required — The address value formatted according to channel type: - SMS/VOICE: E.164 phone number (such as "+18005550100") - WHATSAPP: Phone number with whatsapp prefix (such as "whatsapp:+18005550100") - RCS: Sender ID or phone number with rcs prefix (such as "rcs:brand_acme_agent" or "rcs:+18005550100") - CHAT: Customer-defined string identifier
    - `channel` 'VOICE' | 'SMS' | 'RCS' | 'WHATSAPP' | 'CHAT', required — Channel type for a Communication address.
    - `participantId` string — Participant ID associated with this address.
    - `deliveryStatus` 'INITIATED' | 'IN_PROGRESS' | 'DELIVERED' | 'READ' | 'COMPLETED' | 'FAILED' — Delivery status of a Communication to a recipient. - INITIATED: Communication is initiated to be sent at a future time - IN_PROGRESS: Communication is in the process of being sent - DELIVERED: Provider confirms the Communication has been delivered - READ: Recipient has read the Communication (channels that support read receipts, e.g. WhatsApp, RCS) - FAILED: Communication could not be sent or delivered - COMPLETED: Deprecated and unused. Never emitted; do not rely on this value.
  - `createdAt` string, date-time — Timestamp when this Communication was created.
  - `updatedAt` string, date-time — Timestamp when this Communication was last updated.
  - `occurredAt` string, date-time — ISO 8601 timestamp when the communication occurred.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2026-08-27** (v2) `f039dce07916` — 1 warning
  - added the new `READ` enum value to the `recipients/items/allOf[subschema #2]/deliveryStatus` response property for the response status `201`

[Change history](https://skmtc.dev/twilio/apis/conversations-v2/changes/v2/Conversations/:ConversationId/Communications/post.md)

---

[API](https://skmtc.dev/twilio/apis/conversations-v2.md) · [All operations](https://skmtc.dev/twilio/apis/conversations-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/conversations-v2/revisions/f039dce07916/schema)