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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Path Parameters

<ParamField path="memory_id" type="string" required>
  The unique identifier of the contact memory record.
</ParamField>

### Body Parameters

<ParamField body="facts" type="object" required>
  Key-value pairs to merge with existing facts. New keys are added, existing keys are updated.
</ParamField>

### Response

<ResponseField name="data" type="object">
  The updated contact memory object.
</ResponseField>

<ResponseField name="data.id" type="string">
  Unique identifier for the contact memory.
</ResponseField>

<ResponseField name="data.facts" type="object">
  The merged facts object.
</ResponseField>

<ResponseField name="errors" type="null">
  Error array (null on success).
</ResponseField>

### 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"
  }
}
```

<ResponseExample>
  ```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"
      }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)