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

> Update an existing contact's information.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**contact\_id** `string` *required*

The unique identifier of the contact to update.

### Body Parameters

**name** `string`

Updated name for the contact.

**email** `string`

Email address to add or update for the contact.

**external\_id** `string`

External ID to add or update for the contact.

**metadata** `object`

Custom metadata to merge with existing metadata. New keys are added, existing keys are updated.

### Response

**data** `object`

The updated contact object.

**data.id** `string`

Unique identifier for the contact.

**data.org\_id** `string`

Organization ID the contact belongs to.

**data.name** `string`

Contact's name.

**data.metadata** `object`

Custom metadata associated with the contact.

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

ISO timestamp when the contact was created.

**data.updated\_at** `string`

ISO timestamp when the contact was last updated.

**errors** `null`

Error array (null on success).

```json Response theme={null}
{
  "data": {
    "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "org_id": "11111111-2222-3333-4444-555555555555",
    "name": "John Smith",
    "metadata": {
      "source": "web_signup",
      "preferences": {
        "language": "en"
      },
      "verified": true
    },
    "created_at": "2025-07-20T10:30:00.000Z",
    "updated_at": "2025-07-22T16:00:00.000Z"
  },
  "errors": null
}
```

```json Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Contact not found"
    }
  ]
}
```

***

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.