Skip to main content
POST
Add User to Memory

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The unique identifier of the memory to add the user to.

Body Parameters

string
required
The phone number of the user to add to the memory.
string
Custom metadata text to associate with this user in the memory.
string
Initial summary text for this user’s interactions.
string
Optional external key for additional memory validation or cross-referencing.

Response

object
Response data confirming user addition.
string
Success message confirming user was added to memory.
object
The user object that was added to the memory.
string
Unique identifier for the user entry in the memory.
string
The memory identifier this user was added to.
string
The phone number that was added.
string
The metadata text associated with this user.
string
The summary text for this user.
string
ISO timestamp when this user was added to the memory.
number
Number of calls associated with this user.
string|null
ISO timestamp of the most recent call, or null if no calls yet.
null
Error array (null on success).

Notes

  • If the phone number already exists in the memory, this endpoint will error with a MEMORY_ADD_USER_ERROR
  • Metadata can be any text string relevant to your use case
  • The summary will be enhanced over time as more calls are added to this user’s record

Docs for agents: llms.txt