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

# Create Memory

> Create a new memory to organize and track call interactions by phone numbers.

### 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).

```json Response theme={null}
{
  "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
}
```

```json Missing Name theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "INVALID_REQUEST",
      "message": "Memory name is required."
    }
  ]
}
```

```json Server Error theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "MEMORY_CREATE_ERROR",
      "message": "Failed to create memory."
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.