---
title: "Create Conversation Summaries"
method: POST
path: "/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries"
tags: ["ConversationSummaries"]
---

# Create Conversation Summaries

`POST /v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries`

## Request

- Base URL: `https://memory.twilio.com`
- URL: `https://memory.twilio.com/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries`
- Auth: HTTP basic

Create one or more conversation summaries associated with the specified profile. Supports both single summary creation and batch creation of up to 10 summaries. Supports request compression for large batch operations and response compression for the response. All summaries will be automatically indexed for semantic search capabilities. The content summary can be up to 4KB in length. Each summary will be created with a unique ID in Twilio Type ID (TTID) format.

## Headers

- `Accept-Encoding` string
- `Content-Encoding` 'gzip' | 'deflate' | 'br' | 'compress'

## Request body

- CreateSummariesRequest: Request payload for creating one or more conversation summaries. Supports creation of up to 10 summaries.
  - `summaries` SummaryCore[], required: Array of summaries to create in a single batch operation.
    - `source` string: The source system that generated the summary. Allows letters, numbers, spaces, periods, underscores, hyphens, and forward slashes.
    - `content` string, required: The main content of the summary.
    - `occurredAt` string, date-time, required: The timestamp when the summary was originally created.
    - `conversationId` string, required: A unique identifier for the conversation using Twilio Type ID (TTID) format.

## Response `202`

Conversation summary creation accepted and is being processed.

- SummariesCreatedResponse: Response for batch summary creation.
  - `message` string, required: Confirmation message for the operation.

## Other responses

- `308`: This resource has moved.
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: This error indicates that you have sent too many requests to the API. You should retry according to the `Retry-After` response header.
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

> 12 revisions in range; 1 not diffed.

- **2026-10-06** (v1) `8f92a002d9f1`: 1 warning
  - changed the pattern of the request property `summaries/items/source` from `^[a-zA-Z0-9 _.-]+$` to `^[a-zA-Z0-9 _./-]+$`
- **2026-08-11** (v1) `b0ed05460bbf`: 7 breaking
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `400`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `401`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `403`
  - the `code` response property's max was increased from `99999.00` to `999999.00` for the response status `404`
  - …3 more

[Operation history](https://skmtc.dev/twilio/apis/memory-v1/changes/v1/Stores/:storeId/Profiles/:profileId/ConversationSummaries/post.md)

---

[API](https://skmtc.dev/twilio/apis/memory-v1.md) - [All operations](https://skmtc.dev/twilio/apis/memory-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/memory-v1/revisions/1c9618b83dfd?raw)