---
schema_version: "1"
id: 8a6b901f40caf0dcdcd5763013ae16a8734c955948ec32617a5f6f737a3b1a95
title: Create Memories
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/agentic-memory-context/references/agentic-memory-context-ref/agentic-memory-api-create-memories.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-create-memories.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 038d0b83c3fd8adc6be3a1da196940a847ca700878bc616d301e749c9a2fcd6e
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# Create Memories

Create one or more memory entries for a profile. Each entry receives a system-generated memory ID.

**URI:** `/api/v1/agentic/memory`

**Format:** `application/json`

**HTTP Method:** `POST`

**Authentication:** Bearer JWT

## Query Parameters

| Parameter    | Type   | Required | Description                                                   |
| ------------ | ------ | -------- | ------------------------------------------------------------- |
| profile_id   | String | Yes      | Profile ID of the Individual or User.                         |
| profile_type | String | Yes      | Type of profile. Values: `individual`, `employee`.            |
| category     | String | Yes      | Partition key for the memory entries, such as `PROFILE_FACT`. |

## Request Headers

| Header        | Required | Description         |
| ------------- | -------- | ------------------- |
| Authorization | Yes      | Bearer JWT token.   |
| Content-Type  | Yes      | `application/json`. |

## Request Body Schema

| Field              | Type   | Required | Description                                  |
| ------------------ | ------ | -------- | -------------------------------------------- |
| memories           | Array  | Yes      | Memory entries to create. Minimum one entry. |
| memories[].content | String | Yes      | Memory content.                              |

### Example Request

```json
{
  "memories": [{ "content": "Prefers EST scheduling" }, { "content": "Allergic to peanuts" }]
}
```

## Response Body Schema

| Field               | Type   | Description                                       |
| ------------------- | ------ | ------------------------------------------------- |
| statusCode          | String | Operation status. Value: `created`.               |
| memories            | Array  | The created memory entries.                       |
| memories[].memoryId | String | System-generated identifier for the memory entry. |
| memories[].content  | String | Memory content.                                   |

### Example Response

**Status:** `200 OK`

```json
{
  "statusCode": "created",
  "memories": [
    { "memoryId": "mem_abc123", "content": "Prefers EST scheduling" },
    { "memoryId": "mem_def456", "content": "Allergic to peanuts" }
  ]
}
```

## Error Codes

| Status Code | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| 400         | Bad Request. Invalid request format or missing required fields. |
| 401         | Unauthorized. Invalid or missing JWT token.                     |
| 500         | Internal Server Error.                                          |