Skip to main content
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 for setup instructions.

​
Payload

{
  "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

FieldTypeDescription
eventstringAlways "memory.changed"
data.userProfileIdstringThe end-user’s profile identifier
data.personaProfileIdstringThe AI persona’s profile identifier
data.addedarrayMemories that were created or updated
data.deletedarrayMemories that were removed

​
Added Memory Object

Same structure as the memory object in memory.updated.
FieldTypeDescription
uniqueIdentifierstringMachine-friendly key (e.g. user_has_a_dog_named_max)
targetstringWho the memory is about: USER or PERSONA
categorystringContent category (see categories)
descriptionstringBrief English summary of the fact
eventStartDatestring | nullISO 8601 date (YYYY-MM-DD). Only for EVENT category
eventEndDatestring | nullISO 8601 date (YYYY-MM-DD). Only for EVENT category
sourceTextstringThe original message that produced this memory
timestampstringISO 8601 UTC timestamp when the memory was recorded
tagsstring[]Up to 10 keywords summarizing the memory

​
Deleted Memory Object

FieldTypeDescription
uniqueIdentifierstringThe identifier of the memory that was removed
reasonstringExplanation of why the memory was deleted