.svg?fit=max&auto=format&n=fnPhXvYfm-TNmZho&q=85&s=dc407af2e287b4714cedea5b8d7abf4d){kind=logo}
MCP tool: create_account
Creates a new account in the Thena platform. This tool allows you to set up comprehensive account information including basic details, classification, health status, and custom fields.
Example prompt
Create a new account named "TechCorp Solutions" with primary domain "techcorp.com"
Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The name of the account |
| primaryDomain | string | Yes | The primary domain of the account |
| secondaryDomain | string | No | The secondary domain of the account |
| website | string | No | The website URL of the account |
| industry | string | No | The industry name (e.g., Technology, Finance) |
| description | string | No | A description of the account |
| source | string | No | The source of the account (e.g., “hubspot”) |
| accountOwnerId | string | No | The user identifier of the account owner |
| logo | string | No | The URL of the account logo |
| status | string | No | The account status (e.g., Prospect, Active) |
| classification | string | No | The account classification (e.g., Enterprise) |
| health | string | No | The account health status (e.g., Red, Green) |
| annualRevenue | number | No | The annual revenue of the account |
| employees | number | No | The number of employees of the account |
| billingAddress | string | No | The billing address of the account |
| shippingAddress | string | No | The shipping address of the account |
| customFieldValues | array | No | Custom field values for the account |
| addExistingUsersToAccountContacts | boolean | No | Whether to add existing users matching the email domain |
| metadata | object | No | 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 created account with the same structure as theget_account tool.
Sample response
{
"data": {
"id": "ACC002",
"name": "TechCorp Solutions",
"description": "Leading technology solutions provider",
"source": "manual",
"logo": "https://example.com/logo.png",
"statusId": "STATUS002",
"status": "Prospect",
"statusConfiguration": {
"id": "STATUS002",
"name": "Prospect",
"color": "#F59E0B"
},
"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": "techcorp.com",
"secondaryDomain": "techcorpsolutions.com",
"accountOwner": "John Doe",
"accountOwnerId": "USER001",
"accountOwnerEmail": "john.doe@company.com",
"accountOwnerAvatarUrl": "https://example.com/avatar.jpg",
"annualRevenue": 10000000,
"employees": 500,
"website": "https://techcorp.com",
"billingAddress": "123 Tech Street, Silicon Valley, CA 94025",
"shippingAddress": "123 Tech Street, Silicon Valley, CA 94025",
"customFieldValues": [
{
"fieldId": "CUSTOM001",
"value": "Premium"
}
],
"metadata": {
"leadSource": "Website",
"dealStage": "Qualification"
},
"createdAt": "2025-07-25T12:50:38.937Z",
"updatedAt": "2025-07-25T12:50:38.937Z"
},
"status": true,
"message": "Account created successfully!",
"timestamp": "2025-07-25T12:50:38.937Z"
}