Documentation version: 2026-11-16.2
Canonical: https://docs.creator.gg/tools/conversations_messages_list.md

# conversations_messages_list

Read one page of verified written messages only: Email, SMS, supported social and internal comments. The type filter is always sent; unexpected call, booking, Live Chat or unknown rows fail closed. No sends, transcripts, recordings, attachments or read-state changes. Read guides/contact-context.

## Execution

Call this MCP tool at https://mcp.creator.gg/mcp. The connection selects the workspace. A tool name is not a REST route.

Effect: reads data or returns an account-screen link.


## Example arguments

Examples illustrate the schema. Replace placeholder IDs with workspace IDs and recalculate dates. For mutations, use a new requestId for each new action and retain it for identical retries.

```json
{
  "contactId": "contact_example",
  "conversationId": "conversation_example",
  "limit": 20,
  "type": [
    "TYPE_EMAIL"
  ]
}
```

## Input schema

Generated from the executable tool contract. The behavior notes and related guide cover rules that JSON Schema cannot express.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contactId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "conversationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "lastMessageId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "type": {
      "default": [
        "TYPE_SMS",
        "TYPE_EMAIL",
        "TYPE_FACEBOOK",
        "TYPE_GMB",
        "TYPE_INSTAGRAM",
        "TYPE_WHATSAPP",
        "TYPE_INTERNAL_COMMENTS"
      ],
      "minItems": 1,
      "maxItems": 7,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "TYPE_SMS",
          "TYPE_EMAIL",
          "TYPE_FACEBOOK",
          "TYPE_GMB",
          "TYPE_INSTAGRAM",
          "TYPE_WHATSAPP",
          "TYPE_INTERNAL_COMMENTS"
        ]
      }
    }
  },
  "required": [
    "contactId",
    "conversationId"
  ],
  "additionalProperties": false
}
```

## Result interpretation

Inspect status, message and operation-specific data; list and record shapes vary. A completed read or accepted request does not prove delivery or publication. Reconcile unknown outcomes. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [contact-context](https://docs.creator.gg/guides/contact-context.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)


## Import and sync data

For initial import/backfill or ongoing ingestion of new users/people, companies and many-to-many memberships, read [Import and sync data](https://docs.creator.gg/guides/data-ingestion.md). It distinguishes field definitions from values, stable external IDs from changed emails, native webhook/API routes from Creator MCP, and actual writes from handoffs.
- [Email subscription preferences](https://docs.creator.gg/guides/email-preferences.md)
