> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.dumgum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# memory.changed

Sent when memory changes are detected and the project is configured with `memoryWebhookMode` set to `CHANGES_ONLY`. Contains only the **added and deleted memories** from the latest update.

See the [Memory Webhook guide](/content-creation/memory-webhook) for setup instructions.

## Payload

```json theme={null}
{
  "event": "memory.changed",
  "data": {
    "userProfileId": "user_123",
    "personaProfileId": "persona_456",
    "added": [
      {
        "uniqueIdentifier": "user_has_a_dog_named_max",
        "target": "USER",
        "category": "PET",
        "description": "Has a dog named Max, a 3-year-old golden retriever",
        "eventStartDate": null,
        "eventEndDate": null,
        "sourceText": "My dog Max is a golden retriever, he's 3 years old",
        "timestamp": "2026-04-10T15:00:00Z",
        "tags": ["dog", "max", "golden retriever", "pet"]
      }
    ],
    "deleted": [
      {
        "uniqueIdentifier": "user_has_a_cat",
        "reason": "Replaced by more accurate pet information"
      }
    ]
  }
}
```

## Fields

| Field                   | Type     | Description                           |
| ----------------------- | -------- | ------------------------------------- |
| `event`                 | `string` | Always `"memory.changed"`             |
| `data.userProfileId`    | `string` | The end-user's profile identifier     |
| `data.personaProfileId` | `string` | The AI persona's profile identifier   |
| `data.added`            | `array`  | Memories that were created or updated |
| `data.deleted`          | `array`  | Memories that were removed            |

### Added Memory Object

Same structure as the memory object in [`memory.updated`](/api-reference/content-creation/webhooks/events/memory-updated#memory-object).

| Field              | Type             | Description                                                                                                           |
| ------------------ | ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| `uniqueIdentifier` | `string`         | Machine-friendly key (e.g. `user_has_a_dog_named_max`)                                                                |
| `target`           | `string`         | Who the memory is about: `USER` or `PERSONA`                                                                          |
| `category`         | `string`         | Content category (see [categories](/api-reference/content-creation/webhooks/events/memory-updated#memory-categories)) |
| `description`      | `string`         | Brief English summary of the fact                                                                                     |
| `eventStartDate`   | `string \| null` | ISO 8601 date (`YYYY-MM-DD`). Only for `EVENT` category                                                               |
| `eventEndDate`     | `string \| null` | ISO 8601 date (`YYYY-MM-DD`). Only for `EVENT` category                                                               |
| `sourceText`       | `string`         | The original message that produced this memory                                                                        |
| `timestamp`        | `string`         | ISO 8601 UTC timestamp when the memory was recorded                                                                   |
| `tags`             | `string[]`       | Up to 10 keywords summarizing the memory                                                                              |

### Deleted Memory Object

| Field              | Type     | Description                                   |
| ------------------ | -------- | --------------------------------------------- |
| `uniqueIdentifier` | `string` | The identifier of the memory that was removed |
| `reason`           | `string` | Explanation of why the memory was deleted     |