Get all customer contacts - Thena AI

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.

Example prompt

Get all customer contacts for account ACC001 with contact type "Decision Maker"

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:

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

Sample response

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