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

# Create Observations

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

## Request

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

Create one or more transient observations associated with the specified profile. Supports both single observation creation and batch creation of up to 10 observations. Supports request compression for large batch operations and response compression for the response. All observations will be automatically indexed for semantic search capabilities. The content can be up to 4KB in length and should contain relevant information about the profile. The createdAt and updatedAt timestamps will be automatically set to the current time. Each observation 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

- CreateObservationsRequest: Request payload for creating one or more observations. Supports creation of up to 10 observations.
  - `observations` ObservationCreateRequest[], required: Array of observations to create in a single batch operation.
    - `content` string, required: The main content of the observation.
    - `occurredAt` string, date-time, required: The timestamp when the observation originally occurred.
    - `source` string, required: The source system that generated this observation. Allows letters, numbers, spaces, periods, underscores, hyphens, and forward slashes.
    - `conversationIds` ConversationID[]: Array of conversation IDs associated with this observation.

## Response `202`

Observation creation accepted and is being processed.

- ObservationCreatedResponse: Response for batch observation 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 `observations/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/Observations/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)