> ## 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 bulk customer contacts

> MCP tool to create multiple customer contacts in a single request in the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `create_bulk_customer_contacts`

Creates multiple customer contacts in a single request. This tool is useful for bulk importing contacts or creating multiple contacts for an account at once.

<Admonition type="note">
  You must provide an array of contact objects. Each contact requires an accountId and email, with other fields being optional.
</Admonition>

### Example prompt

```prompt theme={null}
Create bulk customer contacts for account ACC001 with contacts John Smith and Jane Doe
```

<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\_bulk\_customer\_contacts</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name     | Type  | Required | Description                         |
| -------- | ----- | -------- | ----------------------------------- |
| contacts | array | Yes      | List of customer contacts to create |

#### Contact object structure

Each contact in the `contacts` array contains:

| Field       | Type   | Required | Description                                         |
| ----------- | ------ | -------- | --------------------------------------------------- |
| accountId   | string | Yes      | The account ID to associate the contact with        |
| firstName   | string | No       | First name of the contact                           |
| lastName    | string | No       | Last name of the contact                            |
| email       | string | Yes      | Email address of the contact                        |
| phone       | string | No       | Phone number of the contact                         |
| jobTitle    | string | No       | Job title of the contact                            |
| contactType | string | No       | Type of contact (e.g., primary, billing, technical) |
| metadata    | object | No       | Additional metadata for the contact                 |

### Response fields

The response will contain a summary of the bulk creation operation:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr><td>total</td><td>number</td><td>The total number of contacts provided</td></tr>
    <tr><td>created</td><td>number</td><td>The number of contacts successfully created</td></tr>
    <tr><td>skipped</td><td>number</td><td>The number of contacts skipped due to existing contacts with the same email</td></tr>
  </tbody>
</table>

### Sample response

```json theme={null}
{
  "data": {
    "total": 3,
    "created": 2,
    "skipped": 1
  },
  "status": true,
  "message": "Bulk customer contacts 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 customer contacts in the system. Contacts with duplicate email addresses will be skipped.
</Admonition>

***