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

# Update account

> MCP tool to update an existing account in the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `update_account`

Updates an existing account in the Thena platform. This tool allows you to modify any account information including basic details, classification, health status, and custom fields.

<Admonition type="note">
  You must provide the account ID. All other fields are optional and only the provided fields will be updated.
</Admonition>

### Example prompt

```prompt theme={null}
Update account ACC001 to change the status to "Active" and set annual revenue to 7500000
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>update\_account</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name                              | Type    | Required | Description                                             |
| --------------------------------- | ------- | -------- | ------------------------------------------------------- |
| id                                | string  | Yes      | The unique identifier of the account to update          |
| name                              | string  | No       | The updated name of the account                         |
| primaryDomain                     | string  | No       | The updated primary domain of the account               |
| secondaryDomain                   | string  | No       | The updated secondary domain of the account             |
| website                           | string  | No       | The updated website URL of the account                  |
| industry                          | string  | No       | The industry name (e.g., Technology, Finance)           |
| description                       | string  | No       | An updated description of the account                   |
| source                            | string  | No       | The updated source of the account (e.g., "hubspot")     |
| accountOwnerId                    | string  | No       | The updated user identifier of the account owner        |
| logo                              | string  | No       | The updated URL of the account logo                     |
| status                            | string  | No       | The updated account status (e.g., Active)               |
| classification                    | string  | No       | The updated account classification (e.g., Enterprise)   |
| health                            | string  | No       | The updated account health status (e.g., Green)         |
| annualRevenue                     | number  | No       | The updated annual revenue of the account               |
| employees                         | number  | No       | The updated number of employees of the account          |
| billingAddress                    | string  | No       | The updated billing address of the account              |
| shippingAddress                   | string  | No       | The updated shipping address of the account             |
| customFieldValues                 | array   | No       | The updated custom field values of the account          |
| addExistingUsersToAccountContacts | boolean | No       | Whether to add existing users matching the email domain |
| metadata                          | object  | No       | Updated additional metadata for the account             |

#### Custom field values structure

Each custom field value in the `customFieldValues` array contains:

| Field   | Type                       | Description                    |
| ------- | -------------------------- | ------------------------------ |
| fieldId | string                     | The ID of the custom field     |
| value   | string/number/boolean/null | The value for the custom field |

### Response fields

The response will contain the updated account with the same structure as the `get_account` tool.

### Sample response

```json theme={null}
{
  "data": {
    "id": "ACC001",
    "name": "Acme Corporation",
    "description": "Updated: Leading technology solutions provider with expanded operations",
    "source": "hubspot",
    "logo": "https://example.com/logo.png",
    "statusId": "STATUS003",
    "status": "Active",
    "statusConfiguration": {
      "id": "STATUS003",
      "name": "Active",
      "color": "#10B981"
    },
    "classificationId": "CLASS001",
    "classification": "Enterprise",
    "classificationConfiguration": {
      "id": "CLASS001",
      "name": "Enterprise",
      "color": "#3B82F6"
    },
    "healthId": "HEALTH003",
    "health": "Green",
    "healthConfiguration": {
      "id": "HEALTH003",
      "name": "Green",
      "color": "#10B981"
    },
    "industryId": "IND001",
    "industry": "Technology",
    "industryConfiguration": {
      "id": "IND001",
      "name": "Technology",
      "color": "#8B5CF6"
    },
    "primaryDomain": "acme.com",
    "secondaryDomain": "acmecorp.com",
    "accountOwner": "John Doe",
    "accountOwnerId": "USER001",
    "accountOwnerEmail": "john.doe@company.com",
    "accountOwnerAvatarUrl": "https://example.com/avatar.jpg",
    "annualRevenue": 7500000,
    "employees": 300,
    "website": "https://acme.com",
    "billingAddress": "123 Business St, City, State 12345",
    "shippingAddress": "123 Business St, City, State 12345",
    "customFieldValues": [
      {
        "fieldId": "CUSTOM001",
        "value": "Premium"
      },
      {
        "fieldId": "CUSTOM002",
        "value": "Strategic"
      }
    ],
    "metadata": {
      "lastContactDate": "2025-07-25T10:00:00Z",
      "dealStage": "Closed Won",
      "contractRenewalDate": "2026-07-25T00:00:00Z"
    },
    "createdAt": "2025-07-24T07:19:10.258Z",
    "updatedAt": "2025-07-25T12:50:38.937Z"
  },
  "status": true,
  "message": "Account updated successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

<Admonition type="warning">
  This tool modifies existing account data. Only the fields you provide will be updated; other fields will remain unchanged.
</Admonition>

***