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

# Add User to Memory

> Add a new user/phone number to an existing memory.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**memory\_id** `string` *required*

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

### Body Parameters

**phone\_number** `string` *required*

The phone number of the user to add to the memory.

**metadata** `string`

Custom metadata text to associate with this user in the memory.

**summary** `string`

Initial summary text for this user's interactions.

**external\_memory\_key** `string`

Optional external key for additional memory validation or cross-referencing.

### Response

**data** `object`

Response data confirming user addition.

**data.message** `string`

Success message confirming user was added to memory.

**data.user** `object`

The user object that was added to the memory.

**data.user.id** `string`

Unique identifier for the user entry in the memory.

**data.user.memory\_id** `string`

The memory identifier this user was added to.

**data.user.phone\_number** `string`

The phone number that was added.

**data.user.metadata** `string`

The metadata text associated with this user.

**data.user.summary** `string`

The summary text for this user.

**data.user.created\_at** `string`

ISO timestamp when this user was added to the memory.

**data.user.call\_count** `number`

Number of calls associated with this user.

**data.user.last\_call\_at** `string|null`

ISO timestamp of the most recent call, or null if no calls yet.

**errors** `null`

Error array (null on success).

```json Request theme={null}
{
  "phone_number": "+12345678900",
  "metadata": "25 year old customer",
  "summary": "The user described their age"
}
```

```json Response theme={null}
{
  "data": {
    "message": "User added to memory successfully",
    "user": {
      "id": "11111111-2222-3333-4444-555566667777",
      "memory_id": "12345678-1234-1234-1234-123456789012",
      "phone_number": "+12345678900",
      "metadata": "25 year old customer",
      "summary": "The user described their age",
      "created_at": "2025-07-22T05:26:49.139Z",
      "call_count": 0,
      "last_call_at": null
    }
  },
  "errors": null
}
```

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

### 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](https://docs.bland.ai/llms.txt)


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