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

# Create account

> MCP tool to create a new account in the Thena platform.

import Admonition from '@theme/Admonition';

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

<Admonition type="note">
  You must provide the account name and primary domain. All other fields are optional.
</Admonition>

### Example prompt

```prompt theme={null}
Create a new account named "TechCorp Solutions" with primary domain "techcorp.com"
```

<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>create\_account</code> tool with the correct arguments.
</Admonition>

### 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 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 created account with the same structure as the `get_account` tool.

### Sample response

```json theme={null}
{
  "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"
}
```

<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 creates new accounts in the system. Ensure all required information is accurate before creation.
</Admonition>

***