POST
/
v1
/
memory
/
create
Create Memory
curl --request POST \
  --url https://api.bland.ai/v1/memory/create \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "name": "<string>"
}'
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "created_at": "2025-07-21T07:24:49.883Z",
    "user_id": "87654321-4321-4321-4321-210987654321",
    "name": "Docs Example",
    "memory_duration": null
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body Parameters

​
name
string
required
The name for the new memory. Used to identify and organize your memories.

​
Response

​
data
object
The created memory object.
​
data.id
string
Unique identifier for the newly created memory.
​
data.created_at
string
ISO timestamp when the memory was created.
​
data.user_id
string
Unique identifier for the user who owns the memory.
​
data.name
string
Name of the created memory.
​
data.memory_duration
null
Duration setting for the memory (null indicates no duration limit).
​
errors
null
Error array (null on success).
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "created_at": "2025-07-21T07:24:49.883Z",
    "user_id": "87654321-4321-4321-4321-210987654321",
    "name": "Docs Example",
    "memory_duration": null
  },
  "errors": null
}