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

# Get all customer contacts

> MCP tool to retrieve a paginated list of all customer contacts in the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `get_all_customer_contacts`

Retrieves a paginated list of all customer contacts in the organization. This tool supports filtering by account ID and contact type, along with pagination for efficient data retrieval.

<Admonition type="note">
  This tool supports pagination and optional filtering by account ID and contact type.
</Admonition>

### Example prompt

```prompt theme={null}
Get all customer contacts for account ACC001 with contact type "Decision Maker"
```

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

### Input parameters

| Name        | Type   | Required | Description                                        |
| ----------- | ------ | -------- | -------------------------------------------------- |
| accountId   | string | No       | The identifier of the account to find contacts for |
| contactType | string | No       | Contact type of the customer contact to find       |
| page        | number | No       | Page number for pagination (default: 1)            |
| limit       | number | No       | Number of contacts per page (default: 10)          |

### Response fields

Below are the fields you may see in each customer contact object in the response:

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

  <tbody>
    <tr><td>id</td><td>string</td><td>Unique identifier of the customer contact</td></tr>
    <tr><td>firstName</td><td>string</td><td>First name of the customer contact</td></tr>
    <tr><td>lastName</td><td>string</td><td>Last name of the customer contact</td></tr>
    <tr><td>email</td><td>string</td><td>Email address of the customer contact</td></tr>
    <tr><td>phoneNumber</td><td>string</td><td>Phone number of the customer contact</td></tr>
    <tr><td>avatarUrl</td><td>string</td><td>Avatar URL of the customer contact</td></tr>
    <tr><td>accounts</td><td>array</td><td>Array of associated accounts with id and name</td></tr>
    <tr><td>contactTypeId</td><td>string</td><td>ID of the contact type</td></tr>
    <tr><td>contactType</td><td>string</td><td>Name of the contact type (e.g., "Decision Maker")</td></tr>
    <tr><td>customFieldValues</td><td>array</td><td>Custom field values for the contact</td></tr>
    <tr><td>metadata</td><td>object</td><td>Additional metadata for the contact</td></tr>
    <tr><td>createdAt</td><td>string (ISO8601)</td><td>Creation timestamp</td></tr>
    <tr><td>updatedAt</td><td>string (ISO8601)</td><td>Last update timestamp</td></tr>
  </tbody>
</table>

### Sample response

```json theme={null}
{
  "data": [
    {
      "id": "CONTACT001",
      "firstName": "John",
      "lastName": "Smith",
      "email": "john.smith@acme.com",
      "phoneNumber": "+1-555-0123",
      "avatarUrl": "https://example.com/avatar.jpg",
      "accounts": [
        {
          "id": "ACC001",
          "name": "Acme Corporation"
        }
      ],
      "contactTypeId": "TYPE001",
      "contactType": "Decision Maker",
      "customFieldValues": [
        {
          "customFieldId": "CUSTOM001",
          "data": "Senior Manager",
          "metadata": {}
        }
      ],
      "metadata": {
        "department": "Engineering",
        "lastContactDate": "2025-07-24T10:00:00Z"
      },
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "CONTACT002",
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "jane.doe@acme.com",
      "phoneNumber": "+1-555-0456",
      "avatarUrl": "https://example.com/jane-avatar.jpg",
      "accounts": [
        {
          "id": "ACC001",
          "name": "Acme Corporation"
        }
      ],
      "contactTypeId": "TYPE002",
      "contactType": "Technical Contact",
      "customFieldValues": [],
      "metadata": {
        "department": "IT",
        "lastContactDate": "2025-07-23T14:30:00Z"
      },
      "createdAt": "2025-07-24T08:19:10.258Z",
      "updatedAt": "2025-07-24T08:19:10.258Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  },
  "status": true,
  "message": "Customer contacts retrieved 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>

***