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

# Create Observations

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

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, and URL-safe symbols. Excludes URL-unsafe characters like quotes, angle brackets, and control characters.
    - `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

---

[API](https://skmtc.net/twilio/apis/memory-v1.md) · [All operations](https://skmtc.net/twilio/apis/memory-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/memory-v1/revisions/5fb6167593e7/schema)