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

# Update Contact Facts

> Merge new facts into a contact's memory record. Existing keys are updated and new keys are added, but no keys are deleted. Facts are structured key-value pairs (e.g. name, plan, timezone) that persist across all conversations.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

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

The unique identifier of the contact memory record.

### Body Parameters

**facts** `object` *required*

Key-value pairs to merge with existing facts. New keys are added, existing keys are updated.

### Response

**data** `object`

The updated contact memory object.

**data.id** `string`

Unique identifier for the contact memory.

**data.facts** `object`

The merged facts object.

**errors** `null`

Error array (null on success).

### Facts Examples

Facts can store any structured information about the contact:

```json theme={null}
{
  "facts": {
    "name": "John Doe",
    "company": "Acme Corp",
    "role": "CTO",
    "preferred_contact": "phone",
    "timezone": "America/New_York",
    "plan": "premium",
    "account_number": "ACC-12345"
  }
}
```

```json Response theme={null}
{
  "data": {
    "id": "mem-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "org_id": "11111111-2222-3333-4444-555555555555",
    "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "persona_id": "persona-12345678",
    "agent_number": null,
    "summary": "Customer is a premium plan subscriber.",
    "facts": {
      "name": "John Doe",
      "company": "Acme Corp",
      "role": "CTO",
      "preferred_contact": "phone",
      "timezone": "America/New_York"
    },
    "recent_messages": [...],
    "created_at": "2025-07-20T10:30:00.000Z",
    "updated_at": "2025-07-22T16:00:00.000Z"
  },
  "errors": null
}
```

```json Error Response theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "BAD_REQUEST",
      "message": "facts is required"
    }
  ]
}
```

***

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.