.svg?fit=max&auto=format&n=fnPhXvYfm-TNmZho&q=85&s=dc407af2e287b4714cedea5b8d7abf4d){kind=logo}
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.
Example prompt
Update account ACC001 to change the status to "Active" and set annual revenue to 7500000
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 thecustomFieldValues 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 theget_account tool.
Sample response
{
"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"
}