Skip to main content

​
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

NameTypeRequiredDescription
idstringYesThe unique identifier of the account to update
namestringNoThe updated name of the account
primaryDomainstringNoThe updated primary domain of the account
secondaryDomainstringNoThe updated secondary domain of the account
websitestringNoThe updated website URL of the account
industrystringNoThe industry name (e.g., Technology, Finance)
descriptionstringNoAn updated description of the account
sourcestringNoThe updated source of the account (e.g., “hubspot”)
accountOwnerIdstringNoThe updated user identifier of the account owner
logostringNoThe updated URL of the account logo
statusstringNoThe updated account status (e.g., Active)
classificationstringNoThe updated account classification (e.g., Enterprise)
healthstringNoThe updated account health status (e.g., Green)
annualRevenuenumberNoThe updated annual revenue of the account
employeesnumberNoThe updated number of employees of the account
billingAddressstringNoThe updated billing address of the account
shippingAddressstringNoThe updated shipping address of the account
customFieldValuesarrayNoThe updated custom field values of the account
addExistingUsersToAccountContactsbooleanNoWhether to add existing users matching the email domain
metadataobjectNoUpdated additional metadata for the account

​
Custom field values structure

Each custom field value in the customFieldValues array contains:
FieldTypeDescription
fieldIdstringThe ID of the custom field
valuestring/number/boolean/nullThe 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

{
  "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"
}