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

# crm_object_records_search

Find existing company or custom object references through documented searchable properties. One page, not a saved Smart List or associated-record segment. Keep query unchanged across pages.

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

## Behavior and limits

Only the public query, page, pageLimit and string-array searchAfter contract is accepted. Follow nextPage with the same object/query and an empty searchAfter for page-number traversal. Current response cursor examples mix numeric/string values while the request schema allows strings only; this tool does not coerce or invent cursors. Output is IDs and a bounded primary display value, not all properties, saved Smart Lists or relationship segments.

## 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
{
  "objectKey": "custom_objects.product_workspaces",
  "query": "name:Example",
  "page": 1,
  "pageLimit": 20,
  "searchAfter": []
}
```

## 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": {
    "objectKey": {
      "type": "string",
      "maxLength": 160,
      "pattern": "^(business|custom_objects\\.[a-z][a-z0-9_]{0,99})$"
    },
    "query": {
      "default": "",
      "type": "string",
      "maxLength": 300
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "pageLimit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "searchAfter": {
      "default": [],
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "required": [
    "objectKey"
  ],
  "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

- [crm-relationships](https://docs.creator.gg/guides/crm-relationships.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)
